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Preface 



A d«lta gukd« Is a dsscrlp^oh of 
some^mlng new In tprms of Its 
diffecencei from sornettilng the 

f'&Qdsr Olfeady knows o&oyt TP\B 
name cornes from tti© way 
mDthemgtlcians use ttie Greek 
letter d&fJa {&) lo represent a 

difference. 



The Apple* IIGS'"''^ pers-onj.] cocnpytcr is an Apple H wiih many 
advanced hArdwane features, new fifniware featureji, and a ^oftw^re 
toolbi^Jift similar lo Lhe loolbox Jq ihe Macintosh™ personal 
compuier. To describe the many different aspects of Lhe 
Apple MGS, tiiere are several tef^hnical books. Togciher, those 
books make up the Appte IIGS tedmica.! manuial suite. 

Aft lhe first book tn the suite, this book, the J^chnical Iniwduction 
to ihs Apple lies, hajs several objectives. They are 

D to describe the feaitires of the Apple l[cs 

n to serve as a delta guide fof pufchasecs of the Appk IIGS 
Upgrade for the Apple lie 

D lo explain the general design of the Apple IlGS 

n to intfoduce hardware designers to the Apple IIGS 

n to describe the dilTereiit program envlrorunents in the 
Apple IIGS 

G to introduce programmers lo lhe Apple Tics ToolboK 

p to introdyce developers to the Apple IIGS Programmer's 

Workshop 

The Apple fTGS Is an Apple El with a difference-nor rather several 

diJfcjicnecs. Thase diflerences are particularly important to the 
pemon who purchases an Apple IlGS Upgrade, which add^ the 
features of the Apple llGS to an Apple He. By providing technical 
information about the added J'eaiurts, the Technical Introduction 
scrv-es as a delta ^ide foj- the upgraded Apple He, 
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The d«»kFop iFnviranm4nf Is a 
so? of program iQatdmz that 
rnoka user 4ntef actions wltn an 
application r&semble opec otiona, 
on a oesktop. Tn^i usst ^^letts 
objects Of cofnmancis by using 
tne mous* to mov^ O pointer qr 
the soeen. 



Where the Appte HCS Oumer's Gwit^e describes the Apple IIGS from 
the point of view of the user, the Technice^ Introdt-iciion describes 
the Apple UGS from tlie poini of view of ihe application program. In 
other wortls, it describes the ihings ihe programmer has to consider 
while designing a program, such as the opcraiing fcaiures tJie 
program tt5e$ and the environment in which Uje program runs. 

Like Caul, the set of att programmers staLrtJng out on the Apple lies 
is divided into three paft^: 

prt^grammers who are familiar wiih one or more cornpillsifs in 
the Apple n family 

E programmer who are famillaf with the Apple Maciniosh 

n prograrnmcM^ who are not familiaf with either line oF Apple 
Cfimjiuiers 

The Technics fnirodiiciion addresses all three kinds of 
programmers. That means ihc book oricn describes features of the 
Apple UGS ihat arc also found on some other Apple machines and 
so ate already ramiliar to some programmers. To make ii c^isy lo 
skip oveJ" such descriptions^ they are labeled eitlier as Apple II or 
Macintosh information. 

Chapter 1 of the T&chnicai Iniroduction SiSijm by listing the features 
of the Apple IICS, with emphasis on the new fearure-s thai make the 
App^c lies more pfjwerful than earlier models of the Apple IJ. It 
aio contains a list of the features that provide compatibility with 
those earlier modeUs and a list of the features ihac resemble those oF 
the Macintosh. The latter part of the chapter discusses fispects- ot tiie 
Apple IIGS i\ui will be of interest lo developers: the Apple TIGS 
TtXflbox, the progfamiming languages, the Apple IIGS 
Programmer's Workshop^ and the technical manuals. 

The next three chapters describe the features listed in Chapter 1. 
Chapter 2 describes the hajxiw-are, Chapter 5 describes the I/O 
features fwhich involve both hardware and firmware^ and 
Chapter 4 describes the other firmware. 

Chapter 5 introduces an important new software feature of ilie 
Apple IIGS: the Toolboj^p which Is a set of built-in program took. 
Ihe Apple llGS Toolbox supports the desktop eoviroQineot and 

makes it easier for application programs to take advantage of the 
new hardware features. 

Chapter 6 explains the design of the Apple RCS, Including a 
summary of ihe machine's archiiecture and a description of it^ 
memory features. 
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Chapter 7 describes ihe different program environments on ihc 

Apple lies, ihai is, ihc different operating features snd the way they 
are used by difTerent Types of proKrams. 

Chapter 8 describes other programming Issues such as program 
compaittbility with cariter mndels in the Apple If family. 

Chapter 9 iniroduces software developers to the Apple llG-S 
Programiner's Workshop CAP^O, which 1.5 a connplete development 
sy^Eem including an editor, a compiier, and a linker, 

The^qsstry lists technical terms used in thLs book. Some of the 
lerms are also defined in marginal glosses near where they first 
appear En the lejtL 

There are two appendices. Appendix A, "Roadmap to the 
Appte JIGS Technical Manuals," tells aboui ihe other technical 
manuals and helps you decide which ones ytm injcd. Appendix Bj 
"Summary of Program Environments," Is a summary of 
information from Chapter 7, *'Prograjii Environments.'' 



Notation and conventions 

"Hiis manual has a few special ways of indicatirig a term or a piece of 
information that is different tn some way. 



Technical terms 

The first dmc a specialized term appears in this manual it is printed 
in boldface* AH such lerms are defined in the glossary' at the back of 
the book. Some of iticm arc also defined in marginal glosses, as 
shown in ihe next section, 

Here are some names that arc used in a specific ^sv^y to distinguish 
among the different members of {lie Apple II famtty; 

■ Apple Ht Any of several computers in the Apple It famliyi which 
is made up of the Appk: 11, the Apple IT Plus» ihe Appk: lie, the 
Apple Uc, and the Apple IlCxS. 

■ Standard Apple D: Any computer in the Apple II family occ^ 
the Apple IIGS. 

■ 8-bit Apple II; Artotlicr way of saying standard Apple II. All 
those computers have S-bit microprocessors. 



Notollon and conventloris xilt 



■ MKAppte Hi Any siandard Apple 11 ih&t has at least 64K of 
RAiM. l"hat includes ihc Appfe He, the Apple Re, and an AppEe tl 
or Appli^ n Plus with 48K of RAM and the Apple Language Card 
Insulled. 

■ 128K AppI^H: Any .standard Apple II with boch main and 

aLixitiaiy 64K tanks of RAM. That indudes all mndets nf the 
Apple lie and some models of the Apple He, induding diose with 
the Ek tended SO-Column Text Card installed 

The IciLcr K ii ihe abbreviation for kUo-, meaning thousand. In this 
book^ ITstandsi foj: kllohyte (W24 bytes^ except when dealing wiih 
memory ICs^ when it stands for kUubk — 1024 bits. 



A rrwrginQl glou contojns either 
a d&finWiorH of a term appeoring 
In &old1V:3ce- In the t&va or a 
cnn^i^telmencs ehh^r to 
onoih-or pan of thla b&ok or to 
another Pooii. 



Special messages 

Certain types oF information are sei off in special ways in thjs book. 
l"his IS done in tliiee w^ys; nufginal glosses, notes, and impoffunt 
items. 

^ A^ofe A note Uks^ this usually contains tnfonnaitfof) that is 
interesting but not necessary for an undersianding of Lhe main 
text. Notes have labels such as Note or Reminder. Nqies that 
provide backfiround information about the Apple II or 

Macintosh famsly are labeled Apple Hot Macintosh, 



Important An it'flm Ilka this— wllt% Important In the morg In— contains 

JnforrTM3lion that could keep you from causing Iha con>pytef or 
Its software to nrffllfunctlon. 
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Preface 



Chapter 1 



Introduction 

to ftie Apple lies 



The Appje nc5 personal compLitef is a high-pcyw^ered addition to 
the Apple n family. Like Janus, the god of doorways, the Apple tIGS 
looks in two direciions. Ftrsi^ ii looks toward ibc fuiurc: wiih it5 
many htsh-pcrformanoc fcaiureSf such as improved color disptaj^,, 
advaiK^d sound system, l6-bil micfoprooessor, and larger 
memory, the Apple IICS makes it possible for future application 
programs Lo be mortr powerful. Sccondf the Apple IICS looks 
toward [}ie past: beause ii has the featufes of the Apple ISe and the 
Apple 13 c^ ii can mn most of ihc prugrams wditcn for ifiose 
computers. 



The features of the App[e llGS 

l^c Apple lies has mure Features ihan any earlier Apple IT. So that 
you can get an overall idea of what ^\c Apple llCxS is, this section 
lists its features, 

* I^&; The labies that follow are only summaries ^ lo learn more 
about ijidividual features, plea.se keep reading. Chapters: 2, 3, 
and 4 descritx* the hardware fcatuie-s,. i/O featun^S'^ and 
finnware fea lures, respecttvely. 



A more powerful Apple I J 

The easiest way to describe the Apple TTcs is to list all its featui^s- Tn 
addition to the features of the Apple He and the Apple ITc, the 
Apple IIGS has many new features that set it apart from other models 
of the Apple EE. lable 1-1 describes all the major features, both old 
and new„ 

* A'o/i& Terms that appear in boldface are defined in the 
glossary- 
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Tabis 1-1 

Features of the Apple lies 



Fvalura 



Spvclflcollon 



DBtcr[pMon 



More powerful 

micfoprocessoi' 

Fister operation 



Larger n-temory 
xMemory expajjffiifbll 
Detactied keyboard 



65CS16 

CPU dock speeds of 
1 MHz and 2.S MHz 

2'56K ram. 128K ROM 

24'bLL address bus and 
memory eJtparwion sloL 

TBkieyj 



Apple DeskTop Bus™ Low-cost serial I/O 
interface 



RGB video 

40- and SO-coJumn 
text in color 

Apple M graphics 

Super 1 !i-Hcs color 

graphics 

Desktop user 
mLerface 

hnproved sound 



ConLrol panel 



K, G, B, and sync 

'i'CKU background, and 
border colors 

Lo-Ecs, fil-Res, and 
Dout>le Hl-Res 

Tme 320 X 200 or 640 x 200 
resolution 

Uses Super Hi'Res 
color graphics and 

mouse 

Ensoniq diguat sound IC 
with 32 oscillators 



Built-in desk accc^ssory 



l6-biL microprocessor has Zibit mtcroprooessor 

and 6502 compatibiliiy. 

User can select either of two speeds: the standard 
] MHz speed of the Apple 11^ or fa^ 2.8 MHz 

Speed. 

Built-in memory in dudes the features of a 12BK 

Apple JI. 

Expansion card can estpand RAjM to as much as 
8.25 megabytes. 

Separate keyboard includes cursor keys and 
numeric keypad. 

Supports detacJjed keyboard, mouse, and 
additional 170 devices. 

Provides both ajiaiog ROB andMTSC video 

outputs. 

Text, background, and border can be any of 16 
colois (only with RGB). 

Standard Apple II graphics, including Double 
Hj-Rcs as on 12SK models. 

Improved graphics with up to 16 colors per scan 

line and up to 256 colors on scneen, out of 4096 
possible colors. 

Built-in Toolbox supports desktop interface with 
mousej mcnuSf and windows. 

Digital sampling synthesizer supports 15 
independent voices. CApple IIGS also retains 
stngk'bit sound used in ocher Apple II's, add^ 
volume control.) 

User can set machine parameters Tor dil|I&,y; 
operating speed, serial ports, and di.^k drives. 



The features of the Apple lies 



S 



Table 1-1 (continued) 

Features of ths Appio Wss 



F«atur* 



SpAclflcatlon 



D«ICriplion 



Enhanced Monitor 



MoniLor in ROM 



Applesoft 



Applesoft in ROM 



BuilL-in clock Uroe and date 

Buitt'in serial pom T«fO Standafd serial ports 

Buik4n AppleTalk* ttees one serial port 



Built-in disk port 

Expansion slots 
Game I/O 



Disk I/O port iisii>g 
custom IC 



Seven slots for 
peripheral cards 

External 9-pin jack, 
internal l6-pin socket 



Handles l6-bji and 24-bii addresses, assembles 
and disassembles 65Sl6 and 6502 insimctions, 
pcrfonus 32-bit arithmetic; includes low-level 
I/O routine* for diiiplay and keyboard. 

Applesoft with modiftcations for lowercase and 
80-column operation* 

Clod? haj battery for continuous opcraLLon. 

Serial ports support nioctefns, printers, and 
AppleTatk, (User can stilt use serial card in 
slot.) 

No peripheral card required. User can select 

either serial I/O port lo use fur AppleTalk. 

User can seleci built-in disk port, disk interface 
cards in slots, or both, for as many as six drives 

ai one lime. 

Expansion slots like those on Apple He. 
(Apple II GS does not have auxiliary slot.) 

Supports all existing game ha^d^^*aJe. (Some new 
devices use Apple DeskTop Bus instead.) 



Apple II compatibility 

Even though ihc Apple lEGS has tnany pd>BiMeiJi]t new features, it is 
important to temember that it is an Apple II. That mearts that most 
e?^tsttng programs and peripheral devices as well as future progrartis 
developed for the Apple lie and Apple lie will run on ihe 
Apple IIGS. 

The Apple IIGS has several features that make it compatible with 
earlier models of the Apple 11. Table 1-2 is a list of those features^ 

along with the other models of Apple U that also have ihem. 
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Tabl«1-2 

Apple II feotures or the Appte I log 



ApplA II6S fttaturs 



D*icrlpMon 



Ofher modali 



6502 insmjctian ^t 

IZeK RAM 

Applesoft in ROM 

Monitor in ROM 

40- and 80'Column lext 

Lo-Res color graphics 

Hi-Res color graphics 

Double Ht-Rcs color 
graphics 

Built-in serial pons 
Built-in disk pOft 
Expansion slots (J) 
Came t/O port 



63C316 has emulation mode tor running 65D2 

programs 

Main and auxiiiary 64K baok^, wih languagp- 
card and I/O spaces 

Applesoft BASIC iniefpreter with lowercase and 
80-column features 

Supports low- level I/O and program 
development 

Black-and-white text displays (text in color only 
when used with RGB monilor) 

48 X 40. 16 colors 

2B0 X 192. 6 colore 
56a X 192, 16 colors 

Two RS-232-compatible ports, for modem, 
printer, other serial devices 

Using IWM chip, supports both 5.25-inch and 
3. 5 -inch disk drives 

Slots for peripheral I/O and expansion cards, in 
addition to built-in ports 

9-pin and l6-pin conoeciors for game paddle 
and sketch pads 



All Apple H's 
Apple ITc. 12BK ne 
All Apple \Vs 

All Apple ITs 

Apple ric. He with 128K 
or 80-column card 

AH Apple irs 

All Apple II '3 

Apple lie, 128K He 

Apple lie (similaO 

Apple Itc 

Apple 11 t II Plus, He 
Apple lie, He 



SimilarU]e$ to the MacinJosh 

Comparison of the hardware features of the Apple IIGS and the 
Macintosh will reveal more differences than similarities. Among 
the differences are 

D The Apple IIGS has a 65C816 microprocessor, while the 
Macintosh has a 68000. 

a The Apple lies has a color display, ihe Macintosh is black-and- 
whiie. 

n The Apple IIGS has slots, the Madntosh hasn'L 



The faatures of the Appte Ites 



In applications that use the 
cfeiikfQP us*r intBifpce, 
comiTiOnds oppear aa opilona In 
pu!l> down menus, and fnafarlqt 
t>eirig work&d on E:ipp^r& in 
amai q1 the screen conad 
windows. The user selects 
commonds & aiher moferlol by 
using the mouse to move a 
pointer oround on the screen. 



On ihe other hand, while the two machines' opcrattiig system*i ajre 
dirferent, they both suppori hicrarchtcaJ disk direclorJes- And 
some of the hardware fcaiyrts 4Pe ihe same, such as the detached 
keyboard and the mcHise, 

While the Apple IIGS itself doeisn't work like the Macintosh, 
applies Lions on the Apple llCS will bear a strong pcsemblaiice to 
Macintosh applications. The main reason Is the use of the same 
desktop user laterfaee on both machines. The butlt-in 

Apple lies TooIImk, like ihc Macintosh Toolbox:, makes It easy for 
applications to support the desktop interface. Table 1-3 summarlzj^ 
tlie major points of similarity ^ as well as some of the difTcrcnces, 
between the two machines. The nz-semblanccs arc dcicnbcti further 
in Chapter 5, "The Apple ilGS ToolboK." 



Tobl0 1 -3 

The Appls llss compared wsth 11^© Macintosh 



f«qtura 



Apple liGS ver4lo^ 



Moclntoih verslQfs 



Desktop liser 

interface 

Desktop support 

for applications 

Desktop display 



Display resolution 
Command selection 
Keyboard 

Built-in serial poits 

Built-in disk port 

Operating .system 

ExterrLaE hard disk 



Pull-down menus; data in 
overlapping windows 

Built-in toolbox 

Super Hi 'Res color graphics 

640x200 

AppleMouse™, keyboard optional 

D&tached, with keypad And cyrsor 
keys 

T'B/o ports, using (he 7Jlog SCC chip 
and nS-^22 drivers 

5-25-inch and 3.5-inch drives, using 

the Apple IWiM chip 

Pro DOS* (hierarchical files} 

Ilafd Disk 20i5C wjlh SCSI inlcfface 
card 



Full-dDwn menus; data in 
overlapping windows 

Bi4ilt-in toolbox 

Bit-mapped black-and-white 
graphics 

512x3^2 

AppleMou5C, keyboard optional 

Detached, with keypad and cursor 
keys on Macintosh S^lus 

Two ES-252 ports, using the Zilog 
sec chip 

3-5-Inch drives only 

Hierarchical Tile system 

Hard Disk 20 Q-t^ird Disk 20SC on 
Madntosh Plus) 
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For program developers 

The Appk UGS has several fc;iiures that are impK^fuani (or 
developc]^. Ftrei of all, there is ihc Apple IIGS ToolhoK, a 
collection of built-in prograin routines thai can be called by 
applicatioDs. Then ihcit is the program development 
environment, the Apple TIGS Programmer's Workshop (APW)^ 
which includles the language compilers and their environment. 
"With Uie lfljili~in lootbox, ihe language compilers, the workshop 
programs, and Ihc technical manuals ihai describe thern^ 
developers have everyLhing they need lo develop applioitions for 
liie Apple JIGS. 



The Apple IIGS Toolbox 

Uke the Macintosh, the Apple IIGS has a built-in toolbox whose 

routines can be called by appli anions. The toolbox routines 
include mouse operations wiih nienu.^ and windows to support th& 
desktop user interface. 

Noi all of the tools are tesident in ROM; some of ihem are loaded 
from disk and reside in RAM. The calling mechanism is the same 
regardless of where In memory a tool resides. A tool can even be in 
ROM [nan eariy version of the system and in RAM in a later 
version; an application developed on the early version will run on 
the laier version without modification. 

The Appk IIGS Toolbox includes many functions like the ones in 
ihe Madnlosh Toolbox, bui they are not all the same. There are 
important differences between the msichincs, and those differences 
affect ihc nature and operation of the tools. 

For a summary of the Appk: IIGS Toolbox and more about the 
differences txiiween the tools in the Apple 11 GS and the Macintosh, 
please read Chapter 5, 'The Apple TIGS Toolbox." For a complete 
description of the toolbox, see the Apple //G!s' Toolbox He/erence^ 
Volumes 1 arid 2. 



For program developers 



The Apple llGS Programmer's Workshop 

To provide i consistent working environment. There fe the 
Apple II GS Progfammer's Workshop (APVCO- The developmerit 
crivifcinment consists of two kinds of programs- Qic compiler and 
assembler, which have their own reference manuals, and the 
workshop programs, which are at] described in the AppklIGS 
Programmer's Workshcp Reference. 

The Apple 13 GS Programme f's Workshop is a set of programs that 
Apple provides to make it easier lo develop appJlcations for the 
Apple tlGS. The pfograms in the progranirner's workshop are 

D shell 

D editor 

D linker 

□ debugger 
D ulIIIlIcs 

For more inffjrmation about APW. picas© «ec Chapter 9, 
"Apple lies Developmcni I-nvifonment,' and the manual 
Apple lies Programmer's Workshop Reference r 



Fof more iJiformotion obout 
pfOQrammIng on tha Apple IK5S. 

'Apple lIGS Development 
Envirorwnent." ond then the 
Indlvduol mprrudls Appie IkSS 
f^ogrammGf's Workshop 
/Jeferenee. Appie StGS Wewkshop 
C R&f&rortcQ, and Apple HG$ 
Workshop AiiQmbief R^fer&rtcs. 



AppJe riGS programming languages 

The languages available on ilic Apple IICS include 65816 assembly 
language and C. Thanks to the standard object-file format on the 
Apple ncs, the same linker and loader can handle program 
segments created in either of the a v;i liable programming languages. 
Because tiie languages arc available separately, there is a separate 
manual for cacti one. 

The high-level language in APW is C, Programs written In C can 
easily include sections written in assembly language and In Pascal 
APW C comes with a standard C library and an Apple IlGS interface 
library, which contains the tool calls. 

The APW Assembler is a full-fcaiured macro assembler that 
supports the M\ 6$CS\6 li\stJuetion set. OS'^hilc the 65C816 
instructions include those for ihe 6502 and the 65C02, the assembler 
is not an appropriate development tool for Apple IPs that use those 
microprocessors because APW docs not support x\pple It binar/ 
load files.) 

-> iVoie: The Apple llGS has standard Applesoft BASIC in ROM for 
compaiibitiiy ^nih other Apple Il's. 
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For more Siformaiiipn that wi 
help voLi decide wtMGh monuals 
VCKj need, see Aippend'X A. 
'ftoadmop io the Apple lies 
Technical Martuals ' 



Apple IfGS technicol manuals 

To fy|]y describe ihe Apple llCS, Apple has produced a suite of 

technical manuals. There are manusils Lhat describe the Apple llGS 
compuier itself and other manwals thai describe the development 
tools. Table 1-4 iL^t-S the manuals by category. Depending on ihe 
way you intend to use the Apple IICS, you may need to refer to only 
a fev^' oF the manuals, or you may need to re/er to most of them. 



TQbb 1 -4 

Apple llGS technicol manuals 



Category 



Titli 



Introductory manuals 

Madunc reference manuals 

Toolbox manuals 
Workshop manijal 
Programniing-ljnguage manuals 

Operaiing-s^'stcm manuals 

All'Apple manuals 



Technical Iniroduction to the Apple IICS 
Programmer's Introduction io the Apple IlGS 

Apple lies Ilardwate Reference 
Apple lias firmware Reference 

Apple IlGS Toolbox Reference, Volumes 1 and 2 

Apple lies Programmer's Workshop Reference 

Apple llGS Programmer's Workshop C J-lLfcrence 

Apple IlGS Programmer's Workshop Assembler Reference 

PmDOS 8 Reference 

Apple lies PmDOS J 6 Reference 

Human Intefface Guidelines 
Apple iWumerics Manuoi 



For program developofs 



Chapter 2 



Hardware 
Features 



11 



This chapter and ihe folEowing lwi> chapcen describe thft features of 
the Apple lies, wiih emphasis on the new fcaiures 'ITiis chapter 
covers ihe hardware fciilures, Chapter 3 covers the I/O features, 
which combine elements of hardware and Hrmwafc, and Chapler 4 
covcf5 ihc rest of the firmware fcatufes. 



For detailed dsicrlpttonf o1 the 
iCf In Ihe Apple IGS. consult the 
Apple itGS Hardwaro Reference, 

Tablo 2-1 

Ldrge-sco^a ECs In the Apptd llGS 



Apple llGS fechnotogy 

The Apple tlGS is the most advanced Apple II lo date. It uses scvcrat 
large-scale integrated drcuiis that arc cu5;toni designed for it. These 
ICs arc surface mounted on a four-layer printed circuit board 
mounted iri the bottom oFthc case, By using large-scale custom ICs, 
Ihc designers of the Apple lies were able lo increase the machine -s 
capabilJLtcs with a minimum increase in manufacturing cost. 

Table 2- 1 lists the large ICs in ihe Apple ItCS, including the custom 
ICs. Some of those ICs are mentioned later in this chapter. 



Nam9 



FurtcHon 



Mega a 
SlotmaLker 

Fast t*roccssof Interface (FPD 

Video Graphics Controller 
(VGC) 

Integrated Wor. Machine (IWMD 

Sound General Logic Unit 
(Sound GLU) 

Digital Oscillator Chip 03OO 

Keyboard General Logic Unit 
(Key GLU> 

Keyboard Microprocessor 
(50740A) 



Provides the basic Apple TI addressing and timing 

Provides additional address and control signals for the eKpansion 
slots 

Provides addressing and tJming for fa^t memory; handles 
synchronization of processor and Mega H 

Provides video addressing and signal generation for Super Hi -Res 
display 

Controller for 5.25-inch and 33-jnch disk drives 

Provides interface between the system bus and the Digital Oscillator 

Chip {ixx:> 

Digital sampling sound generator (made by T-asoniq) 

Provides interface between the system bus and Ihe keyboard 
microprocessor 

Supports the Apple DeskTop Bus (inierftoe to the detached 

keyboard, ihc mousCf and similar devices) 



12 



Chapter 2: Harcfwafe Features 



CMOS ijt an obbrovlafion rof 
ComplBmsntoTY Metai OKidt 
Stdcon. wtNch Is on9 of ssveroi 
msrnods of semiconductor 
titegroTed- circuit fab/jcotiort. 
CMD$ devicQi ore 
chQroctfr^^z©d by their tow 
pow^r consurmprion. 



MicToprocessor features 

Tlie microprocessor in ihe Appte HGS bs a 65C^t6 operating in 
conjunction with ihc custom FPI (Pasi Processor Interface} chip, 
The 65C816 is a J 6-bit CMOS design based on the venexabSe 6502. 
T^ble 2-2 lisls its main fciiiurcs. 

Table 2-2 

Features of Mtg 6SCB16 mlcroprocessof 

16 -bit accuniulator 

l6-bii X and Y index registers 

Kclocaiablc direct p^ge 

Relocatable stack 

2'i-bit inicrnal address bits 

8'bit data address bank register 

8-bii program address bank register 

11 new addressing modes 

36 new instructions, for a total of 91 Call 256 operation codes) 

Fast block-move insinjcLlons 

Ability 10 emulaifi 6502 and 65C02 S-bit microprocessofs 



Sixteen-bit processor 

In the Apple IIGS, ihc 65CB16 nDfmaJly operates in ciibcr of iwo 
modes: 6502 emulation mode and 65C816 native mode. Figure 2-1 
shows tJne sisees of ihe registers in emulation mode and in native 
mode. In emulation lEode, the accumulator and index registei^ arc 
eight bits wide, and existing Apple Ti programs run the same as they 
do on any other Apple 11 model. In native mode, the accumulator 
and index registers are sixteen bits wide. The 65GS16 also has 
several new and more powerfu] addressing fn<5dcs ihat lake 
advantage of its 24-bit addressing. The new addressing modes 
operate in cither naiive mode or emulation mode, although the 
shorter fegcsiers in emulation mode make some of them inerfcctive. 

♦ Nole. Native mode can also work with 8-bil data registers, with 
an additional accumulator, the B register. Apple docs not 
recommend 8-bil native mode, but some internal routines use 
it, and developers are free to use it if liiey choose. 



Mlcroprocessof features 



13 



Jfi Rgupe 2-1, the boxes represent registers, and ihc sixes of the 
boxes correspond lo ihc number of bits in ihc registers, as 
indicated by the scales ^i ihe bottom of the Hgure^ Letters in the 
boxes are the names of the registers-, numbefs (00, 01) in boxes 
indjcaic fixed values for those parts of the associated rcgjstei'S. For 
example^ the stack pointer in native mode behaves like a 24 -bit 
register with the upper eight bits permanently K£t to 0. 



6502 Emulofton mode 



6&C816 NoSive modo 



DBI7 



B 


A 




00 


X 




00 


V 



00 


01 


' 1 





PC 1 






PBR 





00 


D 



I 1 I ] 

24 Id S 

POQister lengllnt In bits 

Fl«^ure 2-1 

65C816 registers 



Accumulator 

X lod^x register 

Y ind&x roQlster 

Data bonk rogbt^r 

StQcfc polntef 

Program statui 

Rrogrom countor 

Proororri bonk refllster 

Direct r agister 





i ^ 








V 






D3R 





1 00 


s 



' 


oc 






PBR 





00 


' 



f \ 1 

24 16 8 

Regi^er Idngith In btti 



Two operating speeds 

The Apple lies normally runs its 65C&16 microprocessor ai a dock 
rate of 2.8 MHz. For programs in RAM, the effcciivc speed is about 
Z-5 MHz because the hardware atlocaies a few dock cydes For 
refreshing lite R/VM and cannot execute RAM insLruciions during the 
refresh cycles. Programs in ROM are not affeaed by JIAM refresh, 
so they run at the full 2.S MHt 



T^ 
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Almost all programs can run at ihc 2.5 MHz speed on ihc 

Apple IIGS, even proj^rams originally wriiLen for an 6-bit Apple II. 

The Apple IIGS can also run at the normal Apple II clock rate. 

1 MHje. There are three conditions that can cause the Apple IIGS to 

run at the 1 MHz speed: 

D The user has selected normal speed on the Control Panel. 

P A program is executing an instnjction that uses 1 MHz memory 
(sec the section "Memory on the Apple IIGS" In Chapter 6 for A 
description of I Mil/, memory). 

D A timing-dependent routine is executing; for example, one in a 
disk Interface card. 



This bocik ussi hoxad^hclimal 
numbers for memory oddresws. 
Jh& doMai s^gn bero's a number 
riQrtn&s ttiot the fiumbor ii 
hexodoclmal 



For addltiorral information about 
mflmo*y oo the Apple IKSS. read 
the s&ctlon on memory \n 
Chopt&T 6. 



Memory feafures 

Tltanl<;s to the 24-bit addrtisiing of the 65C816, the Apple IIGS has a 
memory space totaling l6 megabytes. Of this total, up to 8 
megabytes of tnernory are available for RAiM exparLsion, and one 
megabyic Ls availahle for ROM expansion, Figure 2-2 Is a simplified 
version of the Apple IIGS rneniiory map. 

lljc inicrnat memory of the Apple IICS has two main features- it can 

emulate the main and auxiliary memory banks of a 128K Apple II, 
and it can be expanded up to as much as 8.25 megabytes. The next 
two sections dcscfil>e tlicse features. 
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Apple II moin and auxiliary memory 

♦ Apple II: This section describes the way memory \s used in all 
models, including the AppJe Tic and He. If you are ilrcady 

familiar with those machines^ you mighi wani to skip ahead to 
ihc ncxl section. 

The 6502 microprocessor u-scd in ihe originat Apple II can address 
up to 6-lK bytes of memory. The Apple lie and the 12&K versions of 
Lhc Appte He have 128K of memory, which [hey address in iwo 6^K 
banks. To dislinguish ihe two bankSp ihe original 6IK of memory is 
referred lo aji main memory ^nd the additional 6AK 3^ auxiimry 
memojy. In the Apple II G5, banks $00 and $01 work like main and 
auxiliary memory when mnning programs written for the Apple He 
and Apple lie. 

In ihe original Apple U and the Apple tl Plus^ difTerent pans of the 

64K memory space are allocated for different purposes. DyElt-in 
ROM occupies ilie highest addresses, from SDOOO la SFFFF. 
Addresses between SCOOO and SCFFF are allotted 10 built-in I/O 
and 10 the peripheral slots for T/O deviociS and ROM on peripheral 
cards. Applications use memory in ihe ^6K of space below SCOOO, 
except for the video display buffers, which are called pages. There 
are two text display pages and two Hi-Res graphics pagc-s, Table 2-3 
shows their locations. 

Tobi« 2 3 

StandorcS Appig H display poge$ 



Display pog* 



Mornqry Idccihoni 



Text Page 1 
Text Page 2 
Hi' Res Page 1 
Hi Res Page 2 



S040Q-S07FF 
SOfiOO-$OBFF 
$2O0O-S3t-FP 
$^000-S5FFF 



u 
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Tho tottw It In gn addr&s ftofudB 
for Ih3 rani^ of all passible 
valu&i To J that digit For 
9*aT^pie. SOiCffi means ofl ihe 
addr3&5Q£ Drom 5O00Q throyQih 
SDfFF. 



When Apple introduced UCSD Pascal for ihc App^e IT, the "lower 
foity-eighi" kilobytes of memory was tasufncieni, so Apple added 
an expafision card with i6k of RAM. The RAM expansion card was 
pan of the Pascal language package for ibe App3e 11, so k was called 
the Apple Language Card. To make 16K of KAiM addiessable without 
dlstufbing iYmc memof^'-mappcd I/O in the SCkxx space, Apple 
designed ihe card with two 4K banks at SDxxx, In ilic Apple He and 
the Apple lie, the cniire 64K of main ^\M is ir^tatled on the main 
circuit board, hut ihe pccuJiar addressing of the upper banks is 
retained for the sake of compatibility. Apple still refers lo RAM 
memory berwecn SDOOO and SFFR' that has two banks in the SChopt 
space as language-card memory, even when it is on the main 
board. 

The technique for addressing the auxiliary 64K memory space also 
involves switching banks, but is independent of the language<ard 
bank switching. In fact, the auxiliary memory li^is lis own language- 
card space, complcie with two banks at SDxxx, CThe I/O space, 
SCxxx, is the same in both main and a,uxiliajy memory.) 

Figure 2-3 Ls the memory map for an Apple lie or a 128K Apple lie, 
showing the two 64 K memory' banks and the language-card banks 
above $C0O0. 
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f you oro Intsfested In teamrig 
mofe obout the woffcing* of the 
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Ttm Memory Mgnager Is port of 
the toolbox, lis Job \& to oiiocate 
memory so that oppllcallons 
ciAd desk occe$sorles con run 
wtlriout dobttarlng each omef . 



K means irWoftyfe except when 
^ means If/Jobi'f. 1G2j3 bits. 
Similarly, o megoi^J 1$ IC24 
kilobits, and 01 moQisbyte Is 1024 
kMobytei. 



Memory expansion 

The minimum memory bi the Apple IIGS is 256K. Appte U 
programs use 128K of thaL, mapp>cd m rnain and auxiliary memory; 
Lbc sysiem firmware uses pans of the other 128K. Programs written 
for ihe Apple IIGS — ^ihat is, programs dial run ihe 65CB16 
microprocessor in native mode, thereby gaining the ability to 
address more than 12SK of memory — can use up to about 176K of 
the 256 K. The rest is reserved For displayfs and for use by tJje system 
firniiware. 

'11 !£ Apple IIGS also hi& a special card slcn dfidioted lo memory 
expansion. All (he RAM on a memory expansion card is available 
for Apple IIGS application progarrLs that call the Memory 
Manager. Expansion memory i* contiguous: its addres.5 space 
extends without a break through all the RAM on the card Unlike ihe 
Apple He, cxpjiin^ion RAM on the Apple llGS is not limited to use as 
a RAM diski program code can run in any part of RAM. 

<f Note. I'he memory expansion slot on ttrc Apple IIGs is not like 
cither the expansion slots or the auxiliary slot on ihe Apple lie. 
Memory expansion cards designed to run in cither of those 
slots will not work in the Apple IlCrS memory expansion sloL (A 
memory expansion card designed to run in an Apple U 
expannion slot will run in one yf ihc general-purpose expansion 
slots in the Apple JJCS, however,) 

Memory expansion cards For the Apple HCS can be sc:verat dlfTerent 
sizes. Using prescnily available 256 K GcilobiO RAM chips, a 
memory expansion card can have up to a megabyte of addiijon-al 
RAM, When one -megabit R.\M chips become available in quantity, 
a memory expansion card can have up to four megabytes oF RAM. 
(The Apple IIGS will accept expansion RAM up to eight megabytes.) 
The addilBOhAl RAM maps into conliguous 64 K banks starting wjih 
bank $02, as shown earlier in Figure 2-2. 

In addition to expansion RAM, the memory* expansion cards CJin 
also have up to a megabyte of ROM, Tlie additional ROM occupies 
memory' from bank SFD downward lo bank SFO. Portions of the lop 
two banks of expansion ROM are allocated for s>'5iem firmware 
expansion. Th& remaining expanaion ROM is supported as ROiM 
disk — permanent storage for applications^ which ihe system 
handles like di^k files. For addiitional information about memory, 
see Chapter 6. 
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Di^ptay features 

To siart wEih, the App^e II GS has the standard Apple lH vfdeo modes, 
both graphics and text, 3.nd iftc tcxi display is enhanced with a 

choice of colors Tof borders, texl^ »rtd bad<ground In addition, the 
Apple IJGS has buitt-in RGB video and two new Supcf Hi-Rcs 

graphics modes. 



BGB J an qistif eviption for f&d- 
green-Wu&, ea wqv o1 dsoloying 
colcjr vloeo by transmitting th9 
Itirea prim pry colors as tnrcho 
ieoctriife ^gnals. With TTl RGi, 
cnly □ fefw color* aro possible,- 
wit^ onalog R^ft, !h& color 
igncils can taJ{& on any values 
b^iweQn ttieir upper and iowef 
limits, foe a wide range of colori. 

NT5C Is the obbrevlotion for 
HuikfTi^ T&t0visk}f} Standofds 
CommfftsG and refers to o 
metthod Tor tronsmrMlng color 
video informoticin fm homie 

r&Jevlmqn recelV&rg That 
m^rhod is also coiifid compcsit^ 
twcauso It combines all ttie 
Vkioo Informiatioin, sndyding 
color. Into a single jlgnoL 



RGB and composite video 

Tlie Apple llGS has both RGB and composite (NTSQ video 
outputs. Riiher type of video moniior can be used with the 

Appte ncs, alihough an RGB monitor is required for BO'Cotumn 
text in color 

♦ Note: A monochrome moniior wil] work on the Apple ITGS. Alt 
the tiscf has Lo do is connect it to the composite video output 
jack and use the conLrol panel to set the display type to 
monochrome, 

Ttae RGB video hom the Apple llGS is analof RGB. Wiih an 
appropriate RGB moftitor^ the Syper Hi-Res mode can display 

sharp graphics with any of 409fi colors. For the sake of compatibility 
with programs that generate graphics for composite monitors, the 
Hi-Ees and DouWc Hi- Res displays on the Apple lIGS look like 
composite video everi on an RGB moniior. 

^ Hisioricai ncle: At one time, Appte proviiied an RGB adaptor 
card aind an RGB monttor, the AppleColor*''' 100 monitor, for 
the Apple 11, Using that system, Hi-Rcs and EkjubEe Hi- Res 
color displays were restricted to a horizontal resolution of only 
HO, a rcstnctian that does not apply to the Apple IlGS, Note 
that an AppHeColor 100 Monitor requires separate digital 
signals^ so It will not work on the Apple IIGS. 
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Text wtJh color 

The standard video modes on the Apple Hgs include three 

enhancements: colored text, colored backgJ■oand^ and colored 
border. For displaying ^O'cotumn or SO-column icxE on an KGB 
monitor^ ihc user can sclca ;*riy of sixteen standard colors for text 
and any other of the sixteen cnlof:^ for backgroLind. Otie Conira] 

Panel won't let Ihe user set the texL and background colors the 
sanve.) Any of the sixiecn colors can be used for ihe border, ihaL is^ 
the visible part of the display outside the area used for lexC and 
graph iOi. 

♦ Note: Colored text works only with an RGB monitor. T\\& 

composite video outpojt automatically switches to monochrome 
for text displays, making the icKi, background, and border 
colors appear as black, white, or shades of ^ray. 'Vhls feature 
mduces color fringing and imprcn^es the legibility of text 
displayed on composite color monitors. 

^ By the imiy: The untised border around the video display is 
wide enough that information on the edge of the display vifont 
be los* when viewed on video monitors with tlieir picture size 
controls set too big. 



Apple II graphics 

** Apple //rThis section describes gT^phics features found on 
pnany othef models of the Apple 13. If you are already familiar 
wilh the Apple II. you might want to skip ahead to the sedjon 
•"Super Hl'Hes Graphics." 

The Apple TIGS includes the same graphics displays found on the 
AppEe ISc and 126K AppEc lie: Lo-ReSf Hi-Hcs^ Double Lo-Rcs< and 
Double Hl-Rcs. Table 2-4 shows Ihc iipeciUcatjons for these 
displays. 
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labia 2'A 

Apple II graphics displays 



l>1tplay mod* 


^AtolirfEfin 




mbor 
colon 


U9%\mi\Qn$ 


Lo-Res 


40x48 


16 




(one) 


Hi-Rci 


^0x192 


6 




Sorrte cdora canrnDt 
appear side'by'sJde 
in smaU ancas of the 
display. 


Double Lo-Res* 


B0k43 


16 




(none) 


Double IH-Res* 


560 X 192 


16 




(none) 



"Kqt sfupponcd by firmwsLre. 

Dke alii other Apple H's, the Appte DGS displays Lo-Res and Hi-Res 
Color graphics. ApplesofL BAStC, in ROM, includes simple rouiines 
for s^tiing colof* and draining dots and tines , The Apple IIGS also 
has the double graphics modes, but, like other AppEe II's, it doesn't 
have graphics ilrmware for those modes. 

* Atote For the standdrd graphics modes — Lo-Re^, Hi -Res. 3tnd 

Doubk Hi-Res — ihe Apple it us&s a simple crick to gicncraie 

color on a composite moniLor The individual dots in the 
graphics are spaced fust right to stimulate the circuits that the 
monitor usts to extract color information from a composite 
signal, C'n Lo-Res, [lie large dots in the display are made up of 
smaller dots thaL blend together on the screen.) Different 
combinadons of dots make difTerent colors. 



Super Hl-Res graphics 

In addition to the siandard video modes found on ihe Apple lie and 
Apple lie, the Apple IIGS also has two new Super Hs-Res graphics 
modes. Tlie new display modes take advantage of the anaEog RGB 
video output to produce high-qu3tjiy, high -resolution color 
graphics. Table 2-5 lisLs the specifications of the two new graphics 
display modes. 
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Fix*) Is ^ort for picture 
sirnnemt. A ptHol corresporkdi to 
the srna'l&it dot you can dfaw 
on ttie eciT-een. 



Table 2 S 

Sypor Hl-R©s graphics modes 








&«»olullon 


iJli pmr 


Cclori 
(»r lln* 


Colon 
on icraen 


Colon 


Mod« Horiz. 


V*rl. 


poiKibIa 


320 320 
640 6m 


200 
200 


4 blLS 
2bLLs 


16 

^6* 


256 
256* 


4,096 
4p096 



*Diffcrciu piKtih use djiTcrc-ni p*rti ol' the pa]eu,e. 

Id [he rttw Super Hi-I^cs graphics modes, colored doEs have the 
same horizonLat resolution as black-and-white dots. CThat's 
different from the standard Hi-Res and Doqble Hl-Res graphics 
modes, where colored dots are effeciively wider than btack-afiii- 
whiLe dots J Each dot on the Super Hi-Res screen corresponds to a 
pixel, and pixels arc indivisible: the screen does not display' 
individual bats. 

Each piKCl has cjiihdr a l-btt (640 mode) or a 4-hit G20 mode) value 
associated with it, as shown in Fsgujie 2-4, The pixel values select 
colors ffom programmable color tables called paietles- A palette 
cofTStsis of sixteen cniiicSf and each entjy is a 12-bii value 
spedfyirig one of 4096 jKj^sible colors In 320 mode, color 
selection is quite simple: each pixel consists of four biiSf so it can 
select any one of ihe sixteen colors m a pale We. 
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Figure 2- A 
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^Ilharlng 1$ p tecl^nlque fo^ 
otorno^ngi tfio voIugs of 
QdjQcent pixels to cf&ate the 
effect of more colors. 



In 640 mode, color selection is mone compticaled. The 640 pixels 
in each horlsiontal line occupy 160 adj^ccni: bytes of memory, and 
each byte hold? four pijce3s thai appear side-by-^idc on ihc screen. 
The sixteen colors in the palette aee divided tnio four groups; of fow 
coloi^ each. The firai pixel in each horizonial line can select any 
one of fouf colors from ihc third group of Tour In the paleiie. The 
second pixeS selects fnoin the fourth gruyp of four oolois in ihe 
paJette. The third pixel seleoj from the Hrsi group of four coloi^, 
and the fourth pixel selects ff oni the second group, as shown in 
Figure 2-5. The process fepeats for each successive group of four 
pixels in a horizontal line. Thus, even though a given pixel ca,n be 
one of onty four colofs, different pbccls iin a line can lake on any of 
ihe sixteen colors in a palette. Using a fechniquc called dJiberingi 
software for 6-10 mode can take advantage of this color-selection 
sthcmc to display 16'Color graphics on the same screen with fiCi^ 
colymn text. 
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Tgur* 2-5 

Color selectton In 640 mods 
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To further increase ihe number of cotois available on the displajr, 
[here can be a^ many as sLxteen dillercnL paJcties in use ai ihe ^ame 
lime. Each oFthc 200 horizontal lines of pixels can use any one of 
the palettes, giving as many as 256 difTercnt colois ai once. All ihe 

palette infarmaLLon occupies memory adjacent to the display duLa; 
a pictum and its palctlc are normally saved tojgcthcr. 

<^ jVofd- In 320 mode, there is a ^aphics fill option that enables a 
program to filE any ponion of a horizontal Line with a new color 
simply by setting marker values on die boundaries oFthe fill 
area. Because individkial windi>w!5i usually don't control the 
entire width of the screen, this technique is not useful in a 
window cnvironmtnL On she other hand, if you are writing a 
gj^phics package thai lo^cs the e nitre screen, you might want to 
consider using it 






Sound capabilities 

The Apple IIG5 has more powe/fiil sound-generating drcuits than 
any pievious Apple computer, although programs that generate 
Sounds wiLh the single-bit sound output of earlier models of the 
Apple 11 will sdll wtifk on ihe Apple tlGS. 



Single -bit sound 

The standard Apple 11 sound ouipu i consHts of a single blt^ and 
programs produce sounds by switching that bit on and o(t. \n the 
Apple IlCSf you can also adjust the volume of the sounds generated 
this way, by using the Control Parsel or by making a call lo the sound 
tools. 



Digital synthesizer 

In addition to the old slngte-bit sound output, the Apple lldS h^s 
new dijsiital sound system that includes a specLal-purpose synthesizer 
IC called the Dj^f^ OscIILitor Chip, or DOC for short. The IXX; 
which is mide by Ensoniq and used in their line of music 
symbesixers, gencraies suund waveforms from dig[LaE samples 
stored in R/VM Using ihe IXX), the Apple llGS can produce multi- 
pait. multi-Vdicfi nuLsic and other compleTt st>unds wnihoui tying up 
its main proceSiSor* 
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Figure 2-€ is ji blodc dkgmm of the sound sy^mcm of [he Apple IIGS. 
The sound sy^em consists of the DOC, An audio amplifier and 

internal speaker, a connectOf for an externaJ amptiHer anci speaker, 
64K of mde pendent 'RAM for storing sound samples for the DOC, 
And a Guslom IG, ihc Sound CrLU (General Logic Unit)- The Sound 
GLU chip funciions as the sysicm interfaoe lo ihe DOC- in addition, 
it gives the Apple lies the ability to control the volume of sound 
from the old-style singte-bil outpyt. 
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Appte tiGs sound system 



ib^fer to fh» AppiB iiGS Hardwars 
Pflfe.'^nce for details obout th& 
sound system onO ttm DOC. 



The DOC contains 32 individual oscillaioi^, eacJj of which 
generates a signal hy stepping through a tabk of digiml uampEes of a 
sound. In ihE Apple liGS, one oscillator is used a_s a dedicated clock 
fof the E50C and one is reserved for future use, leaving 50. Even 
though each oscillator c^in produce sound independently, it takes 
Xwo oBdliaiofis to pf4xiuce a continuous insliu mental voiee^ so in 
normal use the DOQ can produce up to 15 voices. 

The DOC also has 3 single Siaa^og-io-digiial converter CADQ. If a 

properly conditioned audio signal is connected lo the input to the 
ADC, the DOC can record digital samples of soiinds for later 
pEayback by the DOC's osdilators. C^ou can condition the signal by 
using a iow^pass FilEer with a cutofT no higher than 14 kiiz or by 
adding a sampie-and-hoEd circuit that is synchronized to the DOC's 
clock.) 



Sound copobllitl&s 
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Built-in crock 

The Apple IIGS has a buiU-in rcal-umc dock wiih battery back-up 
during power ifiiernjpLions. The tiser sets ihe Eifne and daic by 
mearti oFibe ControJ Panel. ProDOS uses the dock to sen daie and 
tiine in flEes. 

♦ Noie to dei^ioper^: "{"he Apple IIGS clctck does not \^^ the sime 
oommairtdi as ihe various ihird-pRarty dock pertpherat's. 
Applications can call ProDOS and gp[ the time the same way as 
on an Apple lie, or they can determine which system ihcy are 
runj-iing on and use the calls appfopriate to the dock on tJiai 
system. 
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This diapCer describes ihe I/O features, which have both hardware 
And fErmware aspects. As in Chapter Z, ihe emphasis is on the new 
features. You can find Fuithef descripiiDns of the !/0 features in the 

manuab Appie IIG5 Hardware Reference and Apple Has 
Firmufare Reference. 



I/O expansion stots 

Except for the Apple He, aJI models of the Appier II have T/O 
expansion slots. The ofigi-nal Apple II and the Apple 11 Plus had 
eight slois, numbered through 7. The language Card normally 
occupied slot on those machines. On later models, [nduding Qic 

Apple DGS, the language-card memory is bmit in and there arc only 
seven slots, numbered 1 ihrough 7. 



Slots on the Apple IIGS 

The I/O expansion sIols are designed to accept circuit cards dial 
contain hardware and firmware to control and communicale wth 
peripheral devices. ITic slois are not simply I/O ports; a card in a 
slot has access to the clock and control signals, the data bus, and 
the low-order 16 bits of the address bus. The same signals are 
available on all the slots, except for the color subcarrier, which is 
only on slot 7, In addJiion lo tiie common signals, each slot has tis 
own select signals, which are separately decoded for each slot. The 
slots on the Apple IIGS are almost idcntictal to the slots in an 
Apple He, and can accept most Apple 11 peripheral cards. (Two of 
the slot signals, Inhibit and Sync, work differently on the 
Apple IIGS, and there is a new signal, M2ScIcct; please refer to the 
Apple IIGS Hardware Reference for more information,) 

As far as the slots iheniselives are concerned, any peripheral card 
d-fi operate in any sJoL However, it has become conventional to 
use oeriain cards in certain slots; for example, printer inierfacc in 
slot 1, 80-ccHlumn display in slot 3, and disk conLrollers in slot'i 5 
and 6. Even though later modcb of Apple II have these I/O 
interfaces built in^ compaiibiliiy requires them to have tlic same 
kind of program access that was orJginaJly designed for cards in 
slots. 
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* Peripheral-card CGmpatibiiity; Only [lie low-ordfir 1 6 bits of 
the 244>it address bus are available on the expansion slot^. 
Peripheral cards thai derive ihetr enabting signals by decoding 
the address bus will not work in ihc Apple Dos unless ihey also 
use one of [Jie select signals to verify that the address on the bus 
is in the approprJaic 64 K bank for I/O CUiat is, bank 5E0), 



Apple U Slot memory 

ITiis section briefly describes th^ memory spaces allocated to the 
sloUi. Except for ihcir location in bank SEO and the consequem 

need for shadowing to be on for old-style programs to work, the slot 
memory locations in the Apple IIGS are the same as on any other 
model of the Apple IL If you need all the detaits about slot memory, 
refer to the manuaJ Apple lies Hardware Reference. 

♦ Shadowing fori/Oj in the Apple llGS, I/O uses memory 
locations In bank $£0. To make those locations available to 
6502-based Apple II pjrograms^ which run in banks SOO and 501 ^ 
the Apptc 11 GS has a feature called I/O shadowing that makes 
had and sfone instmctjon,^ to locations in bank SOO also 
happen in bank SBO. For more Informaiion about shadowing^ 
see the section "Memory Shadowing" in Chapter 6, 

♦ Apple H: The rest of this section describes the way the 

expansion slots work on ail models of the Apple [I. If you arc 
almady faniitiar with the Apple II, you might as well skip ahead 
to the next section. 

The microprocessor in an Apple 11 does all its I/O through naemory 
locations. To make the slots accessible to the processor, parts of the 
memory spaoe arc allocated to the slots. In addition to ^c memory 
locations used for actual I/O, there are memory spaces for 
programmable memory (RANi) and for read<jnly memory CRO^0 
on the cards, as described below. 
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Slo» I/O space 

Each expansion slot has the ejrdusive us* of 16 mcrnory IdmSoils 
for daia input and Oiiipul;- The 16 locacinfis fnr ^ given slot have 
addresses $C08x + sO, where x stands for hexadecimial valucjs from 
to F and islands for Lhc sloi number Figure 3-1 shows the 
allDcaiion of I/O addresses for the slots: for exampie, the I/O 
a^d^esses for stoE 3 are SQOBD-SCOBF. Whenever one of Lhose 
addressesi appears on the addit^.5 bus, the 5I01 hafdw^-are activates 
the device select signal in ihat slot, The cifCLiiLs on the card can use 
the device select signal and the low^ordcr four biis of the address to 
activate devicc-s on the card. 



SCOFF 
SCDFO 

SCQEO 
SCODt] 
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$COBtD 
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Figure 3-1 

Slor I/O device locattons 
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PROM ffpnds Tgf prpgifamrin pWe 
raad-oriry .memafy- o lypo of 
ROM dovlcs designed to b& 
programmed after tali^catlon, 
Linliko orcsinorv ROM oevlcea-. 
whicn ore programmed durlr^o 
fabrication. 



SEot ROM $pace 

Each CKp^t^sion sloi has the eKclusive use of one 256-byie page of 

memory sjMce. Most pcrapheral cards use this space for ROM or 
PROM for stoTEng the driver routine that controls the operation of 

Lhe periphcraJ device^ 

The 25S ROM locations for a given slot have addresses iSC^OO, where 
^stands for lhe sloi number. Figure 3-2 shfjws lhe aUocaiion of ROM 
addresses for the slots; for ej< ample, the ROM addresses for slot 3 
are $C30O-SC5I^F, Wlienever one of those addresse-s appears on the 
addi¥ss bu*, the slot hardware activates the I/O select sl^rsal in ihai 
slot- That signal enables lhe ROM device on the card^ and the low- 
order eight bits of the addiess bus dcicrmine which of lhe 256 
locations is being addressed. 
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SCQOa 



Figure 3-2 

Siof ROM locations 



Foi moT9 details, refer to the 
chapter "l^oafQ^i^'Ttlhg for 
PodphQra; Cords' In the 
Appf& St& T&chntca! Refsfonco 



ExponsEoo ROM space 

In addiiion to the small areas of memory allocated to each slot, 
thore is a 2K memory space from $C800 lo SCFH^" that can be used 
by a card in any slot. More than one pcfiphcj^l card can have 
expansion ROM on it, but only one of ihcm can be active at one 
time. 

Each card that has expansion ROM on it mu.st also have a drcutt ihat 
use5 the I/O select and [/O strobe signals on ihe slot to enable the 
ROM, 'Ihc card must also have A circuit to disable the ROiM so that 
other curds can use the same addresses for ihctr expansion ROM. 
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Slol RAM space 

Besides the varioiM locatiDns alBacaLed for dcrvjces on peripheral 
cards, a few locations tn matn memofy arc rC:SCrved Tof variables 
used, by the peripheral-card roudncs. These locaUoa? are called the 
screen holes. Each slot geis one b>'tc in each of the eight small 
blocks of text-page memory, as shown in FigLife 3-3. To dctcnninc 
the addresses of the eight RAM kxations assi^ed to a particular 
sioi, add ihc sloi nurrsber to the starting addresses of the blocks. For 
example, the IU\M locations for slot 1 are $0479, $041^9, $0579, 
$05F9. S067E). So6F9, $0779, and 5071--9. 

♦ Scresn hoks^ The text display buffer (text Page 1) ocoipies 
memory from 50400 to S07n% but there are locations in that 

i^nge [hat an: nciihcr displayed nor modified by the firmware's 
display s-ubrouiines (for example, COUTO. Iliosc lotaiions are 
called the screen holes, and arc used for temporary storage 
cither by I/O routines running Jn pe-ripheral-card ROM or by 
firmware routines addressed as if they were in card ROM. 
(Application programs never use this area of rnemory.) 
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The Ap0m Ik^s l-kjfdwofB 
JTe/afenc© and she Te-chnlcal 
reference manuola for the 
AppJ^i IIq and the Appte lie 
di^scrlbo in detail how □ 
peripheral- cofd rouSlrie qo0$ 
pbout de-fermlnrig Its slol 
numbef 



Finding lh« stot numbef 

The ROM rQLiLmes on 9 peripheral card often need to know which 

slot the card k in. One way Eo do this is to execute a JSfi 0jrnp to 
subroutirK:) insinicLion to a JocatJon with an RTS (return from 
subfoutirvc) inslrucLion in it, then giet ihe return address from the 
stack and derive the slut rturnber from ihat, uiing the formula gi\'cn 
above in ihe eariier section "Slot ROM ^pace.' 



II 



flives o c ampler© description of 
tr» use oT the Coniroi Panel. 



Serial I/O ports 

The Apple IJGS has two butlt-ln serial pons that can substitute for 
s3qe* 1 and 2. fSy using [tic Control Panel desk accessory, ttie user 
can select either the builL-tn port Of ihe card for either 5]oL A built- 
in port can operate while there ts a pefipheral cifd plugg&d into the 
corresponding slotf but Lhe pan. and the ard cannot both run at the 
same time. 

Tlie hardware for the ^rial poits consists of a two-channel Serial 

Communications Convener (7-itog 8530) and KS-422 driver ICs 
connected so as to be compatible with R5-252 devices- The 
firmware for the pons emulates the Eundions of the Super Sen'al 
Card and the Apple He ierial-pon firmware. The Hrmware provides 
input and output buffering as wdl as background printing, as 
described below- 

The fjofts are normaJly^ conftgoied such ihai port 1 is a printer port 
and fxirj 2 Ls a cominunLcations pon. but either port can be 
configured cither way by using the Comrol Panel desk accessory. 
CAUcrnatively, the user can connect either one of tJtic ports to 
AppleTalk: see the section *App[eTalk Interface" later in this 
chapter,) 



Apple II $er[Ql ports 

^ Ai.pie H: This section describes the way the serial pons work in 
other models of the Apple II. If you are familiar with the 
operation of the Apple Super Serial Card or the serial ports on 
the Apple He, you might as well skip ahead to ihe section 'New 
Serial Ron Features." 



Serlcil 1/0 ports 
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This scdiofl describes Ihe basic functions of the serta! I/O ports. 
Those functions are the same on ihe Apple lEGS as on oiher 

Apple ll's with buiU-in ports, even ihough their hardware 
implementation is diiTerenL For compIcLe descriptions of the serial 
ports, refer lo the manuiil Af^le IlGS Firmware Rs/erence. 

BQ\h serial ports are general -purpose I/O portSf compaiible with 
RS-232 siandard devices. Serial pon 1 is inltalliy seL up as an output 
port for a printer or ploner, and $^rls.] port 2 as a communtcatlons 
pori for a modem: Table 3-1 shows the settings. The user can 
change the characteristics of either port by usirtg the Control Panel 
desk accessory. An application can cliange port characteristics by 
n^ans of comunands, as summarized in Table 3-3 and described 
fully in the Apple //^ChJ Firmware RcfeTunceu 



DCD. DSR. ond PTR sTeinci tor 
data CQfTi&F cfe-J&cf. cfcrfa iet 
f&udy. lyitd data fe/mtnirf /aaay. 
respectively, which ore nom&s 
o* sIgna-iS on. the a&^lal porls. 
XOHand XOfF Qm two coritrol 
chorocter5. I/O driver routines 
uia those sfgnols or thosa 
chorocferS for Jiandshaking, 
that la. contreHIng the tronsrer 
of dof a between the computer 
and th& pOh'ipheral devlefl. 



Tobl* 3-1 

Intflol setting? tor serial ports 
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Port 1 



Port 2 



Line lenglh 

Etelete line feed after carriage return? 

Add line feed after carriage retLirn? 

Echo output to display screen? 

Buffering an? 

Data transmission rale 

Number of data biti 

Number of stop bits 

Type of parity checking 

DCD 'type handshaking enabled? 

DSR/DTR handshaking enabled? 

XON/XOFF handshaking enabled? 

Command character* 

•The Control Pand can't cjuirigc ihc oammand character. You diart^ (he 
command character by spending the cuncnt command charaidcr followicd 
b^ a contf d| character, which becomes ibe new cn-mcnand charaaer. Per 
motti JnJctnnatJQfri, &ee the following 5ecik)r:i. 



Unlimited 


Unlimited 


No 


No 


Yes 


No 


No 


No 


No 


No 


96Q0b3ud 


I2£I0 baud 


8 


B 


1 


1 


None 


None 


Yea 


Yes 


Yes 


Yes 


No 


No 


Control-l 


Conlrol-A 



Stital port commands 

Thete are two waysi of controlling a serial port One way, commonly 
used by Applesoft programs or from the Monitor, is to activate a 
port or slot by means of the Input and Prinicf commands, as shoi^vn 
in Tabic 3-2, and [hen send command characters in the output 
stieam, jLS shown in Table 5-3. 
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fmportant 



The second mcihod of conLrotlmg a s£riat port Is by ihe 
sLandardizfid firmware protocol. Your program makes calts to 
command routines whtise addresses your program has found in 
StandardiTcd localions derived from the slot number. The rirmwane 
actually coniaim two separate inierfaces, one for Applesoft BAStC 
and one, called the Pascal 1.1 inicrrace, for other languages. 
Tables 3-^ and 3-5 summari2e the two interfaces lo the firmware. 
For complete descriptions, refer to the Apple JIGS Firmwaru 
Reference. 

Tho manijals for ttT© Sup&r Serlat Card ond for the Apple lie cilso 
IJsf hardware roglstsrs qnd screen-hole locations Tor conholllng 
the ports, if you want your programs to njn properly on ttw 
Apple llc3& ond oo future models of the Apple 11. do not control 
the ports by meons oT the hardware; use colls to the firmware or 
use the tootbox. See frte sec Hon 'Sertal Port Compotlblltty.'' 



h Tables 3-2. 3-^. Qr\<i ^5, lt\s 
teMor i stands for trie port 
nunber, either 1 or 2. 
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Tabfe 3-2 

Input ond Pilntef cornmands 



functlen 



AppltioM command Moniroi comrnand 



Start input on port s lN#s 

Stan output on port s PH#5 

Tabie 3-3 

Summory of f/O commands 



s Control- K 

s Controi-P 



Cdmmanicl DeKflpflon 



nnnN 
nnB 

C 

nD 

F 
I 
K 



Set line width to nnn 

Set baud rate to one of 15 standard values selected by 

nn, Lowest ralc is %, highest is 19,200. 

Send automaijc carriage r&tum whenever Lirte width 
e^cceedcd 

Set data format — number of data bits and stop 

bits — to seLiing specified by n. Data bits can be 5, 6, 

7k or 8^, slops biLs, 1 or 2. 

Disable keyboard to prevent disturbing input 

Echo oytpitl to display soeen 

Disable automatic line feed alter carriage return 



'1 
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Sunnmarv of I/O commands 



GomiTKind DeKilplJon 



L 

M 

ftp 

Q 
ft 

S 
T 
X 

z 



Generaie auDonudc lane feed after carriage rciuni 

Mask oul CdcUiie) inooming line-reed characters 

Sei parity as selected by n. Parity can be cvErtj odd, 
mark, space^ or none. 

Quit CluTD ofD icrmtnal mode 

Hesec part 

Send 3 break charjicter 

Enier termina] mcKk 

Turn on XON/OCOIT I/O prolocol 

Zap {ignore) further commands unLil ControUReset 



Address locoHors foi BASIC protocol 



I 



Addre-u 



D«fcripiieri 



SCsOQ 
SC&05 
SCs07 



In [ya ligation routine (ilso outpuLs a chtracfer) 

Head a character 
Write a chafaclef 



Toblo 3 '5 

Address locdffons lot Pascal 1 . T pf orocioC 



Addroti 



Dftterlpfjan 



SCsQD 

SCsOE 

SCsOF 

$CslO 

SCsU 



Qfliset to initializaLlon routine (Plnii) 

OJIset to read rDutine CPRead) 

OfTset ID write routine CP Write) 

Offset to slatus routine CPSlatus) 

OfT&ct to control rouiine for exiended Interface 



For com plots do*crlpifona ofth^ 
Interfaces to th9 seflol MO 
tfermwore. refer To trio Appt& ilGS 



<► Note; To obiaErt the addnsss of the dcsin^d routine, read the 
offset byte frajm the address given in ihe table and add it to the 
slot address, SCsiOO. To use the extended interface, set up a 
command list and ihien use a JSR lo jump to the address of the 

control rouiine. as described in the Apple flcs Firmware 
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TermFnal emufotlon 

The Apple lies nrmware supports a tciminat emuEaiion mode that 
worlu itke the one in ihe x^pp3e lie. The terminal ennulaUon has i 
miriLmum of rcature;^, and is intended for use only when a fu]]- 
feamred comjiiunicatlons package is not availabEe. The terminal 
emulaaon pas-^e^s chafactets typed on [he keyboard {except 
command strings) to the serial output, and passes serial input to Lhe 
display. 

The user puts the Apple IIGS into terminal mode through the BASIC 

interface by typing 

INtflcT 

where J is the port number and e Is the command cha/aaer Cusually 
Control" 1 for the printer port or Contfol-A fof the corrtmunications 
port). The letter 7" is the tenninal command, as shown in Table 5-5. 
To quit termEnal mode, the user types the command charactef 
foilowed by ihe letter Q, the Quit command. 

When mnning terminal emMlatioii at high baud rate, you can use the 

firmware's buFTcrin^ features (described below) to keep from losing 
chamt^crs during display scrolling. 



New serial port features 

The serial ports on the Apple llGS have several new features In 
addition to tlte ones found on the Super Serial Card and the 
Apple lie. The new features include 

□ VO buUering 

D background printing 

D built-in AppleTalk interface 

This section descn"bes the new features brielly; for more 
informaaon, refer to the manual Appk lf<7S Firmware keferencB. 

I/O buffering 

The seriat-port firmware supports input and output buffering. Each 
port has an input buffer and an output b^jifer. The default buffer si2E 
is IK, which tiie firmware requests from the Memory Manager^ but 
an application can request Larger bulTers (up to 6410 arid pass the 
location and size tO' the firmware. 
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There ajie four ways to Eum on bufTering.: 

D rrom iho conlrD] panel 

□ from the keyboard after Ehe Applesoft PR* command 

D from an application by a command in the DuLpuL sEieam 

D from an applicaiion hy t command to the serial Urmwarc 

OulpuL bufTEflnft puts characters in a I'lFO CrirSL-in^ firsi-ouO quetje 
In the output bufter space, liicn sends ihcm on to the outpiii device 
whenever ii 'is ready. Input buffering put$ ehara<iers into a queue in 
the JnpuL buffer and responds to calls lo the firmware's Read rotJtfne 
with character? from the queue. 

Althooj^ the applicatjon is not involved in ihe intcnupt process 
thai the fBrm^'aiic tjscs to suppojt buffering^ ihie applicatjon can keep 
ti^ck of buffer activity by rrLaking extended-interface ealLs that return 
the number of chamcters in the input queue or the amount of space 
Icfi in the ouiput queue. Cniosc calls arc InQStaius and OulQSE.atuSi 
refer to the Apple llos Firmmare Reference for descri(itions-) 



BockQfOund printing 

The firmware can send a blD<:k of charactera out a serial port while 
an a ppl [cation h running. This background priming is similar to 
output buffering except that ihe firm ware accepts a Urge number of 
characlers all at once inJitead of getting them one at a time. Vflien 
Lhe firmware iransmiLs the last character in the output bufler, it calls 
a recharge routine, supplied by the application, thai refills the 
bulTer. As with normal bufferings the application can either use the 
defauit ZK buffer or cecTuest its own buffer of up to 64K from the 
Memory Manager. 



ApptaTalk l5> Ajz^e'^ !Qcal-area 
networit for Las&T'MlT9r''and 
frnagoWrlter^'* ii prir^rera crtd 
Apple II ono Macintosh 
comput&rs. Uke Ihe Jvtaginl^osh. 
ttiG /^Dpi9 jI&s hes :h$ AcipieToik 
\r\\etiQc& buiii iri. 



A data overrun oecurs whan 
^put dota comes foataf than 
the computer con occapt If. 



AppleTalk InlerTace 

The user can connect the AppleTalfc network to either one of the 
serial port connectors and activate it by means of the Control Panel 
desk accessory. At any given Lime, only two of three I/O 
functions — AppleTalk, serial port 1, serial pon 2 — can be active. 
CTlie Conlnol Panel ensures that one serial port is made inactivie 
when AppleTatk is selected.) 

So that lhe Appte IlGS can suppon AppleTalk, the interrupt service 
roytine Ls designed to respond to Lhe scrtat-pon: hardware fast 
enough, to preclude data o\'ermcis. In addition, a hardware timer 
generates a system intenupt four times a second to enable the 

AppleTalk firmware to carry out network operauorts. 
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Serial port compatibility 

Even [liough ihe commands used to communicaLe with the serial 
pan nrmwarcr are the same ±s ihose in the firmware on the Super 
Serial Card C^nd simitar to the ones in the Apple 13c), some existing 
programs using ihcac ports will not be compatible with the serial 
ports on the Apple IIGS, The reason is that many programs, 
espcdally communicaLions packages, bypass the Jfjfmware 
commands and go directly to the hardware. Programs that control 
the hardware directly won't be compatible with the Apple IlGS, 
because it iise.s tht; 6530 Serial Communlcatioas Chip CSCQ,, not the 
6551 Asynchronous Communications Interface Adapter (ACIA) 
used in the Super Serial Card and the Apple lie. 



Programs that use the port to control a printer are more likely to 
the nrmwai^e commands, making them compaiiblc with the 
Apple IIGS. The sart^e gcx;s For most applicatioas written in 
Applesoft or Pascal. Apple Works'^** and MousePaJnt"^** are examples 
oTprograrmi ihat control the ports by calls co the firmwaje and so 
arc compatible with the Apple IIGS. 

Even programs that use the firmware can get into trouble if ihey 
CDoimunicate with the firmware by modifying the contenLS of the 
The tcFAdn hoi*i ore loco^ions In screen holes. The *eri3l-port firmware takes ihe place of ROM in 

rh& rexr d-spicy page that p'e ^l,,f^ ^ ^^^ 2. so it uses the scrcen-iiolc locations for those slots. 

used bv Hio ROM on cards irt ^ . . , . ,. , ^ 

e;<portsion slots, os described In Kailii-r than making proper calls to the firmware, some programs 

rtio aafiier secticin 'Slot RAM control the operation of the firmware by changing the values in 

^P*^^' those locations. While thai may work on a particular model of 

Apple n, the firmware in anotJicr model may not react the same 

way. For complete information about the serial ports, refer to the 

manual Apple IlGS pirmwaTTS Refenmce. 



Built-in disk port 

The Apple llGS has a built-in disk port like the one on the Apple lie. 
The disk port uses an IC called the Pft'M (Integrated Woz Machirve) 
and can handle up to stx drives, conneaed in a daisy chain. The 
drives can include one DuoDisk* (which counts as two drives}, up 
to two UniDisk^" driven, and four UniDisk 3-5 or Apple 3.5 (unified) 
drives. 

^ A'o/e; Disk II* 5-25-inch drives wont work with the built-in port 
because their connectors won't fit. Ihey work fine with a Disk U 
controHer card Installed in an cjcpansion sloL 



Built-in disk port m 



. 



Boot 1$ $hort for i^<iol%kap lodd, 
a term *ugaeitlve of iti© 
dlfflcuHv of InWiol loodlng of 
loador progroms into eony 
compytera maf adn't have 
byilMn flrmwafe In ROM. 



^ Af^}le H: The earliest form of disk storage availabte for ihe 
Apple n consLsied of Disk II coiHroller cards and Disk U drives 
using 5.25-inch floppy disks wtih 143K storage capacity. Each 
conLTDllcr card could handle one of two drives- for more than 
iwo disk drives, you needed addiLional conirDller cards. The 
conventional location for ihe first controller card was sloi 6[ the 
second card weni in slot 5. For jnicial loading (booting) from 
disk, Ihe siartup rouUnc in the firmware started widi sIdl 7 and 
tried successively Eowcr-numbered s!ou uniil it found one with a 
disk conLrolter card in ii. Most software for the Apple I! w^s 
designed to use sloe 6, drive 1^ as its startup drive. On more 
recent Apple 11 's thai have a buili-ln disk interface, Ihe slot and 
drive nomendaiure is less meaningful, but it is still the 
convention because so many programs designed that way are 
still in use. 

The disk-port firmware handles drives addressed as internal slots 5 
and 6. You can also insiall a disk interface card in slot 6 and liave 
two additional 5.25-inch drives (although you can't use all the 
drives at the same time). You CJin boot the Apple IIGS from dri^r I 
in either slot Using the Control Panel desk accessory, ycm can 
determine whether the Hrmwaie will look for the boot device in 
slot 5, in slot 6, or scan downT^-^rd (torn a specified slot. 

The disk-port firmware also controls /RAM5, a block-storagc device 
emulated in RAiM and activated as slot 5^ drive 2. When /MAM 5 is 
active, the firmware accesses the second 3.5-inch disk drive a,s 
slot 2, drive 1. See Appie //G'i Finnwarv Reference for information 
about RA^rl disk 



A btock l/D dtvic* reods or 
wrltej Information in ofganlzad 
groups called blocks. t>^caiiv 
6 12 bytes. A dis^ drive h a block 
disvlcfl. 



SmartPorf and Protocol Converter 

SmartPort is a set of assembly-language rouiines used to support 
block I/O devices. The HSmartPort firmware includes the Pfotocol 
Con^icrtcr software used in the Apple lie 3.5 ROM revision. 
SmaftPort supports two 5-25- inch drives, two Apple 3.5 drives, up 
to 127 UniDisk 3 5 drives, and the RANI disk volume /KANi5. CTlie 
disk-port hardware can handle a maximum of six drives.) 
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Apptioilklftt can malce calls to rhe SmartPort to perform ihe 
foUowLng rynctioris: 

n obtaLrting status informaLion about a device 

□ PCseLLing a device 

□ formatting ihc medium in a device 

D reading from a device 

D wriLiixg, to a device 

O sending CDnirol information to a device 

Calls to SmartPort use the same technique as [he Pascal 1.1 protoctjl 
suimimarired in Table 3-5, except die address values are in the slot 6 
locations. For complcic information about SmartPorij refer to the 
manual Apple llGS Firmware Reference. 



Gam© I/O connectors 

The game I/O connectors can be used for attaching one or two pairs 
of hand contnsllcrs or game paddles, one or Iwo joysticks^ a 
graphics tableif or a similar I/O device designed for use with 
Appte [1 computers, 

♦ Note: Similar I/O devices designed for the Apple Jics can be 
connecicd to the DeskTop Bus, ^iiich is described in the next 
sieciion. 

Like the Apple lie, the Apple II GS has two game I/O conneaors: a 
9-pin miniature D-type connector on the back panel, and a i6'pin 
DIP socket on the main circuit taoard, injiidc the case. 'iTie 9-pin 
connector has four analog inputs (used for hand controllers or in 
pairs for poysticks), ihrcc button inputs, power, and ground. The 
l6-pin socket has the same signals as the 9-pin connector, plus a 
strobe and four single-bit outputs. 



Apple DeskTop Bus 

Ihc Apple DeskTop Bus interface is a simple I/O jnterfaoe with two 
different but related functions. Its primary function is to prm'ide 
intelligent support for the keyboard and the [DeskTop Bus mouse. It 
also provides a convenient way to connect additional input devices, 
such as hand controls, graphics lablcis^ numeric keypads^ and 
other keyboards. 
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A DIK connecfor Is. a type of 
corwieetor wUh ffiUltlplB pins 
Inside a round outof shie'd, The 
Inltldls DIN gtortd foe D&ijfsch& 
imHusffle Normat, a Europeon 
standords orgdnlzotion. 



The DeskTop Bus is i serial imerfa^ C^'O* a sLandard serial I/O pon) 
thai is conLrollcd by iw awn built-in microprocessar^ the Apple 
DeskTop Bus (ADB) micrDcontroller. DeskTop Bus <±c: vices use 
inej^pefisive four-conductor cables in<l foui'-pin miniature DIN 
connectors. Additional devices cortneci in parallel wiih devices 
already insialledL some devl'Des, such as the detached keyboafd^ 
include i lack for connecting other devices. The differeni types of 
devices have difiTejent identincrei if ihere are two devices of the 
same type, the ADB microconiroller assigns ihem dirfereni 
Identifiers. 



I 



The Dvorak rypswfltef 
kfi'yPoerd. also caHsd the New 
Anmfican StanOarst K&ytxiCffd, 
ho5 Iti kfly-s Q^ronged lueh (nat 
It Is more emeient to u^^ than, 
the more common Owelty (for 
the ririrr line of Keys) keyboord 
flfrangement. 



Detached keyboard 

The AppEe IIGS keyboard is the new Apple standard detached 
keyboard. TTie new keyboard layout includes several 
enhancements, most notably a numeric keypad. It also conforms to 
European .standards in the shape and position of the Return and 
Shift keys. 

The Apple DeskTop Bus mlcroconiroUer (ADB micfocontroller) 

supports tlie detached keyix>ard, providing basic scanning and 
encoding along with special features such as a type -ahead buffer. 
'Ilic ADB micfoco-ntfolier supports eight different keyboard 
layouts, making it easier to locals;^; the Apple IIOS for other 
countries, llie ADD micfocontfoller also supports the Dvorak 
keyboard layout, which the user can select by means of the Control 
Panel desk accessoiy, 

TBPith the Appte IIGS Upgrade installed in an Apple Ile^ the ADB 
raicfoconlrnller supports the built-in keyboJird. providing the jsame 
features that are available with the detached keyboard 



Mouse 

The EteskTop Bus provides in ifnproved interface for the 
AppleJ^louse. Although the actual mouse hardware is unlike that 
on either the Apple lie AppicMousc card or the Apple He, the 
caliing sequences are the satnCf as required for program 
eompaiibiliiy. 



42 



Chapter 3: \fO feafures 



The AppleMouse ccxitains a microcontroller thai keeps rrack of the 
movcrrient of ihc moojse up to plus-or-minus 63 tncrcments CtS3F) 

and reports mouse information to ihe DeskTop Bus. whic±i passes ii 
CMi ihe Lhe moiise roLiiJncs in Lhe Rrmwire. Like the ApplcMouse 
card for the Apple He (and unlike the mouse inieiface on the 
Apple lie), the ADR controller reduces the burden thai opera tion 
of the mou5c places on [he main processor, as described in lhe nexi 
seciiofl. 



Fa* gpplleoflonj usif^g tno 
DeskTop Bus. rhero Is o Dej^^cTop 
Bui tool tet: S&© Chopfer 5 tor 
more Intermaifon. 



It Is on Intenupf $lonal 
generated by ttie video flming 
ctrcyit eacJi lime it tiril$hes a 
vertical scon IhQ verflcoi icon 
happens 60 timss a £aco«nd, so 
VBL Is a convergent way to 
con'^ol the frequency of oitTief 
ovanis. such as rnouso 
Inrerrupr*. 



DeskTop Bus firmware 

The DeskTop Bus firmware provides communications and control 
for the detached keyboard (along with the buik-in keyboard when 
the Apple lies Upgrade is insialted in in Apple lie) and the 
DeskTop Bus mouse. It aL^o acts as a simple communications 
inteiface for other input devices such as joysticks and graphics 
tablets. 

The rirmwarc supports mouse operations in somewhat the san^e way 

as the AppleMouse card for the Apple He. Like ihe AppleMouse 
card, the Apple DeskTop Bus supports intermpt-mode operaiion of 
iIk^ mouse, waiting uniil VBL occurs before Interrupting [he system. 
It also provides a true passive modci that is, a mode in which the 
mouse interface doesn'i inicrrupt the application, but waits for the 
application to poll iL Using passive mode, applications an 
operate the mouse while njnning sortW3.re routines that mustn't be 
interrupted, such as criiical timing loops. 

For complete information about lhe operation of Apple DcskTc^ 
Bus, refer to the manual Apple IIGS Firmware Reference. To find 
out how to connect a device to the bus, refer to the Afjple UGS 
Hardware Reference, 



Apple DeskTop Bis 
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Firmware 
Features 



as 



The x\pp3c ItGS has a total of 12BK bytes of ROM for firmwarei 

pcrmanenUy resident program^;. The [Irmwafe includes ihe 
following features: 

□ driver programs for buiU-Jn I/O ports 

n resident desk accessories 

D MoniLor 

D Monitor I/O routines 

O resident toolbox 

D Applesoft BASIC interpreter 

ThLs Chapter describes only the resident desk accessories, the 
Monitor, and the Monitor I/O routines. The built-in I/O ports are 
described in the previous chapter. The coolhox is described in 
Chapter 5 and in the Apple fics Toolbox Reference, Volumes 1 
and 2. AppIcsoFi BASIC has its own manuals: Applesoft Tutorial, 
Appiesqft Reference Afafiual, and BASIC Prt>gramming With 
ProDOS. 



The Desk Marrager. which 
eontroij tirv6 desk accessories, li 
described In ChdpTer 5, -The 
ApptB MGS Toolbox,' The 

dOTcrlbes the operofion of the 
Qor\iro\ Pcihei by Ihe uter. Thei 
/ippie HGS ffimwPTB Reference 
describe* the' operarior^ of r^e 
Control Pone^ by cm opplicatlon. 



Resident desk occessortes 

Desk accessories arc prognimSk usually small, that the user can 
invoke to perform some immcdiaic task wtien some larger program 
is running. When the desk accessory is Tinished, the interrupted 
program can continue, Most desk accessories are loaded from disk 
and reside in RAM, but there are two that arc permanenily resident 
In ROM- the Control Panel and the Alternate DLsplay Mode. 



Control Panel 

The Conirol Panel is a jiermanently resident dc£i accessory that the 
user can invoke while another program is rj nning. The Control 
Panel enables the user to specify the operating parameters for ihc 
following functions; 

D I/O ports: primer or modem, line lengtli, baud rate, and 50 on 

D display; 40 or 80 columns- colore for tC3^l, background, and 
border 

D pitch and volume oF sound to use for tsell 

D Operating &peed; I MHz or 2.5 MHz 

D slot allocation; internal ports or peripheral cards 



1 

i 
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□ &Cajtup sloe 

n language (character seO for keybcafd and display 
D buik-in dock: lims and daLe 



Alfernate Display Mode 

The Alternate Display Mode is a small ftmn^'arc roiitine that can be 
accivaled from the Control Pand. Il makes ihe Apple UGS 
compatible with standard Apple Tl programs that create animated 
displays by rapid aliemauon or rtlpptng of the two Lo-Res graphics 
pages. 

Standard Apple 11 programs running on the Apple TTCS normally 
can't display tcxi Page 2 (also known as Lo-Rcs graphics Page 2) 
because the hardware does not shadow iL If such progranw use page 

flipping for Lo-Res animafion, the display won't look rijght unless 
they can display text Page 2. To run ihe programs on ihc 
Apple IIGS^ the user mu-st first turn on Aliernate Display ModGf 
which periodically transfer.? data from text Page 2 in bank $00 to the 
sainc area of bank SEO, where it can be displayed. 



The Monitor 



The Monitor is a built-in program that provides machine-la ngw age 
access to the registers and memory. The Monitor includes firmware 
L'C) routines to accept commands typed at the keyboard and to 
display Eext on the screen. ITiese I/O routines provide low-level 
input and oulput functions that application programs can also use: 
see the next major section, "Monitor I/O Firmware.' Even though 
the mini-assemblef and disassembler are considered parts of live 
Monitor, this section describes them separately, after the other 
features of the Monitor. 



Using the Monitor 

^ Appiell: This section descrfbes features that are common Eo 

ihc Monitor programs on all models of the Apple U. If you are 
silfeady familiar with ihc Monitor, you might as well skip ahead 
to the section "New Monitor Features," 
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The Monitor is a builL-in uUtity that enables a progratnmfir to 
examine code and <iata in memory and [o execute portions of the 
code, llic Moaitor program occupies memory in ROM bank $FF, 
starting ai location $FF69 C-151). That pan of ROM is mapped into 
banks SOO and $01 by the language-card switches whea Applesoft 
BASIC Of other standard Apple II programs aie running. One way 
lo invoke the Monitor is to have Applesoft running and type 

CPlLL -151 

'%'hen the Monitor is njnning, the prompt character is an asler^k 
C*), When you are finished using the Monitor, you return lo 
Applesoft by pressing ConLrol-Resct or Contfol-C, 

The Monitor does not support the desktop user ioterfaoe. To gjve a 
command to the Monitor, you type a line at the keyboard and press 
Return. Commands contain three kinds of information: addresses, 
data values, and command characters. Addresses arc in 
he^cadecimaL; data values can be in hexadecimal or in the form of 
ASCII characters. 



Monitor commands 

* Apple II- This secLion describes features that are common to 
the Monitor programs on all models of the Apple IL If you are 
already familiar with the Monitor, you might as well skip ahead 
to the section "New Monitor Features.* 

like the Monitor programs in all other models of the Apple II, the 
Apple IIGS .MiKiitor allows progfammers to operate on programs in 
memory at the Iot^tsi level The Monitor includes instructions to 

D display the coniertls of a memory location 

D display a range of memory locations 

D stoie values starting at a location 

D dtsplay the contents of the neglsters 

D change the contents of the registers 

D move a block of memory 

D compare {verily) two blocks of memory 

n direct output to port or slot n 

Q accept input on slot or port n 

D execute program code starting at a location 

a disas-M^-mble code starting at a location 
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Ndw Monitoi' feotures 

Among the new fcalures of [he Apple IIGS Monitor are 

D new commands 

n improved displjiy 

D extended memory addressing 

The Apple IlCiS Monitor also includes enhanced vefsions of the 
Apple U miriHasserabkr and dLsiUiiscmbler, which are dCiJcriiDed 
Jatcr. 



Tho Tool Locator is dsacrlbed In 
Chopper S, 



For descflpnons of th© Monitor 
<:ommfln<&. refer to fho choprer 
er fhe Monitor In rhe Apple iios 



New connmdnds 

The Apple lies Monitor has many new commands. Among thum 
are commands to 

a save and restore regisicrs and rtuxlc settings 

D search memory for a paucm up lo 256 b>'te& tnng 

n fill part of memory with a onc-byie value 

Li make a call To the Tool Locator 

D store a new value inio a sped fie register 

D enter ASCII characters from keyboard into memory 

D change ihe selling of the real-lime dock 

D convert hexadecimal to decimal or vice verst 

D perform 32'bil addition, subtraction, muliiplicalion, and 
division 

D switch between native and emulation modes 



Improved cflsptay 

Many of the Monitor commands display the contents of part of 
memory on the screen. The formal of those displays has \xen 
improved, so ihey now include boih hexadecimal and ASCII values. 



Extended nnemory addressing 

The Apple IIGS Monitor supports all the fcatunes of the new 65C8l6 
microprocessor, IncludLng T6-bil regLsters and 24-bU addres.«ies. 
Tl\e comrtiand syntax now includes two hexadecimal digiis of bank 
address (delimiicd by a slash) so tlie Monitor can address any bank. 



the Monitor 
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ProDOSfl and ProDOS li am 

fhe disk operating sysroms fhot 
fun on the Apple liGS. See 
Chopter S lor descrfcononiS of 
ProDOS B and ProDOS 16. 



Mini-assembler and disassembler 

All models of ihe Apple II have sorne veraon of the dissLssemblefK 
and alt bui the early modcb of ihe Apple He have a mini-assemblci'. 

The Apple IIGS has both. They are enhanced to support: Lhe 65C816 
micfoprocessor's new instructions and long addresses, and they 
support both native and emulation mode. 

The mini-assembler and disassembler are spedal features o( the 
Monitor The mini-aAsembler provides a means of developing and 
debusftmg a program or routirw; in a very simple form of assembly- 
language. 

When you invoke the mini -assembler, the prompt character 
changes to an exclamation point (!) and the Monitor accepts 
65CSI6 instructions in the form 

addr^^ : opcode cperandis 

The address fieEd and the colon are optional; you omit ihem to 

enter consecutive insmjaions. The mini-assembler does nt>t 
maintain a symbol table, but it does recognize alt The standard 
instnjccirtfi mnemonics, and it calculates relative addresses. Ii 
recognizes a preceding number sign (*) as signifying an immediate 
operand. You use the letters X and Y. set oH" by commas^ for 
indexing, and you type indirect addresses inside parentheses. 

To stop the mini-a.^sembler, you ty|")e a null line by pressing the 

Return key. 

Unlike the mini -assembler, which takes over the user interface and 

accepts inputs from the user, the disassembler is pjsi the Monitor's 
List command. It li-^^ts the contents of memory, one screenful at a 
time, converting op codes into mnemonics and relative addresses 
into absolute addresses. 

Both the mlni-assembter and the disassembler can handle all 91 of 
the 65C8l6's instnictions and all 24 addressing modeiii (a total of 256 
op codes). In addition, the dLsassembler properly expands 
operating-system calls to ProDOS 8 and ProDOS IG, showing 
command numbers and parameter-list poiniers on separate lines. 
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Monftor I/O firmware 

♦ Apple II: Tliis scciion describes the Moniior \/0 routines, 
whkh are functionally Lisc same on the Appte IIGS a^ on the 
Apple He and Apple lie. If you are already familiar with ihe 
Moniicir I/O routines, you mighl as well skip ahead lo the 
section "Intcffypt Support.* 

The Moniior accepts inputs from the keyboard and displays 
infomrLation on the screen. To do these tasks, it has its own ]/0 
routines. Every Apple 11 contains some version of die Monitor, so it 
also contains these built-in I/O routines. Because they are always 
available, many appLcation programs use ihem for keyboard input 
W(ui text display output. 



Sfandgrd I/O links 

The Monitor I/O routines include standard input and output 
routines that are used by ihc operating system, by device drivers, 

and by applications. The standard I/O routines pass conLroi on to 
internal I/O routines by way of two locations in RAM called the I/O 
Unks. The I/O links contain the addresses of whatever I/O routines 
are in control at the timCr 

In an Apple II running wiihoul an operating system, the I/O links 

normally contain the addresses of the standard internal I/O 
routines. An operating system typically replaces the linlt addresses 
with the addresses of its own I/O routines, and in turn calls the 
internal I/O routines. 

There are two sets of internal I/O routir^s: one set that exisis in all 

Apple ll's, even die earliestr and another set that exists, only on 
Apple n's that support SQ-column displays. The routines in the 
earlier set are KeyIn and COutI- the eO-column routines are 
C3Keyln and C3COutl, (Key In is pronounced key in and COutl is 
pronounced Cow^ one. C3Key In and C3COutl are pror^ounced 
C three key in and C three C out orw) 



Monitor I/O firmwafe il 



The I/O links ar& iwo-byU^ addresses at locations S0036 and $003S in 
bank SCO: sec Fiaisne 4-1. The link at location $0036 is ihe output 
link; ii is named CSW, for character (cuipuO switch. It holds ibe 
address of the subroutine ihat handles sin^k-chamcljer oytpMt 
When you issue a PR In coin ma nd tfom Ap^l&oh or an 
n Control-P hom ihe Monitor, the firmware changes the addrcss^ 
in this link to the fii^i address in the RDiM space allocated to slot or 
port number n. Subsequent calls to the output link art- thus 
transferred to the firmware associated with that slot or pon. When 
you issue a PR#0 or a Control-P. ihc Hfrnware replaces the slot 
ROtM addre;^ at CSW with the address of the internal output routine. 

Hie link at location 50038 is the inpyi link; it is na/ned KSW. for 
keyboard (inpul) switch. Like l!ie o^tp*it link, it normal Ij^ hotds the 
starting address of a staoHlard routine — in this case, the routine for 
slngle-charader inpuL When you issue an IN#n command from 
Apptesoft or an n Cont rol-K from the Monitor, the nrmware 
changcji ihe address in thts link to the Tirsl address in the ROM space 
allocaicd to slot or pon niamber n Subsequent tails to the input link 
are thus transferred to the firmware associated with that slot or pcirt. 
When you issue an IN#0 or a Contxol-K, the firmware replaces 
ihc slut ROM address at KSW with the address of the internal input 
foytine. 



S0039 


KSWH 


KSW (input) 


$0038 


KSWL 


SOCI37 


CSWH 


CSW (output) 


$G&a6 


cswt 


Figure 
Stondc 
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Input rouMnes 

The Monisof firmware in dudes iwo dl^oftnX subroutines Tor reading 

from ihe keyboard: RdKcy Cpronounced rea4 key') and GeiLn 
Cpronounced gef tine). The RdKey routine provides input of a single 
diaractcr by calling ihe cuffent character input routiiK:, thai is. the 
foutine whose address is stoned in the input linJc at K5^^ Thai 
routine i& normally cither Key In or C3Kcytn, which accepts one 
chaiacter from the keyboard The Keyin routine displays a cursor at 
the current cursor posiiionf waits until someone presses a key, then 
puis ihc ASCII value of thai key inio the accumulator and passes 
control back lo the calling program, 

The GctLn routine provides inpui for entire Knes by making 

repeated calb to the input routine until it gels a carriage return, 
GelLn starts by displaying a prompt: a character that indicates that 
the program is waiting for input. Dirferent programs can have 
dilTcrcril prompt characters simply by storing the desired t icr 

at A specJfied location in RAM. As the u*er types keys, the GetLn 
routine stores the ASCII values into successive locations in the input 
huJTcr in memory locations S02O0^$O2FF. The GetLn rouiine also 
supports some simple screen editing and control features. 



Fty rrofe info^^o'Hon cbouf the 
itorrdcrd nput and output 
'Oulfnes, refer to rtio monuaJ 
Appi^ iSiSS firmware (^fmence. 



Output routine 

Ttie iiandard output routine is named COut Cjyronoiinccd Cout, for 
character ouipuf). It calls the current character output routine, thai 
is, the routine whose addncss is stored in the output link CSW. The 
character output routine is normally cither COutl or C3COutl, 
which sends one character to the display, advances the cursor 
position^ and scroUs the display if necessary, Both character output 
routines restrict their use of the display to an actii^e area called the 
text window, which is determined by four values stored in RA.M: left 
margin, width, top line, and bottom line. 



Ofher routines 

TJjc Monitor firmware also contains other useful routines for 
dealing with the keyboard aiid display. Like the standard I/O 
routines described above, they carry out low-level funaions 
appropriate for the operation of die ^tonitDr, 



ivlonitor I/O flrniworo 
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For mora Information about the 
fflrmwara I/O roytlrias, rater to 
tno manuol jAppte tfss Rmwotf^& 



The firmware routines Indude functEnns mch %s 

D clearing all or specific pans of the screen 

D dcdring ihc screen and pulLing ihe cursor in the uppcr-lcri 
corner 

D drawing colored poinLs and line* in LQ-Res graphics 

D gelling the color of a specified location on the LoRes screen 
O piri.nung oui \hc \^lue in ihe icojrrbyEaior, In hcxad^CEm^l 



Interrupt support 

TT]c nrmwarc includes internjpl support Tor the full range of 
iniorniE-r.-i E ■■ jssiblc an the Apple MGS. A5 in the Apple lie and the 
enhanced Apple ne, the (If m ware on the Apple lies niiikes 
intermpi-dfiven programs possible. Internipts work well with 
ProDOS Cany vereion) and Pascal Oevision 1.2 or higher); DOS 3. 3 
doctsn'i Support inteiTupEs. 

Ihe goal orihc inlen^pt handler is lo support internjpls in any 
mertiory eonfii^uiratton. Ii saves the machine's slate at the lime of 
ihe tntentipt, and puts the machine into a sundard memory 
configuration before passing control to your pmgram's tnicirupt 
handler. 

W'henevcr an internjpt ocni^rs and snrermpcs are enabled, the 

hardwaie uses an addiess called an Jnteffupt vectof, stored in ROM, 
to transfer conirol to Ihc first part of ihe intetrupt handleff also in 
ROM- The system's iniernjpl handler supports intertvipis in any 
memory configuration. It saves the machine'^s state at the dtne of 
the intenrupi, and puis the machine into a standard memory 
conrigu ration before passing control lo your program "^s intcrrupC 
handler. 



Imporlant 



Tl^ Inteirupt vectors aro stofad in systom nOI^4 ibODk SFF. 
locotlons SF FEE'S FFFF). and so is a short Intarmpt service 
routine (bqnk SFF, locoflons SC071'SC07F). For intenupts to 
wcHfk with pfograms ninnJng In bonks SDO and SOT . I/O 
shadowing ond fcinguage-cqrd nxjppifvg must bo on. Table 4-1 is 
a summQiv of Ih^ lypes of interrupts th« firmware recognEos, 
For more InfofnKitbn about irttonrupts. pleaso &ee the nr»anLiaJ 
App^ iiGS Ftftrtwarm Rsfsfence. 
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Tabto4-1 

Ust of AppSe Ngs Interrupts 



IRQ Is short for interrupt mques!. 
wnich 14 a signal Inpuft to the 
miercprocossor requ^stlino xsn 
Nwrupf. D90ern:fina on ttie 
itotG of a fi^ag «rt tti@ proc9»Dr'i 
ifotus reeifif^r. It con either 
noct to an II7Q or ignofs it. 



Typ« oI Intorrupl 



Caui* of ln(ftrrupt 



Program DRK instfuctJon 

Peripheral card IRQ 

VBL 

Vidieo scan tine 

Mouse 

AppleTalk Network 

Timef for AppleTatk 

Keyboard 

SerEal input on port 1 

Serial inpyt on port 2 

Ensoniq DOC 

Clock chip 

Apple DeskTop Bus 

Cold start reset 

Wanri'Siart leset 



A break instruction in a program 

Kcqu&si from a peripheral card 

Vertical-blanking time occurred 

Scan-line Lime occurred 

BuLlon, movement, or VBL 

Address recognition or error 

Occurs every 0,26667 seconds, lo 
trigger event prooessing by 
AppleTalk 

Key was pressed 

Transmitter empty* data received, or 
error 

Transmitter empty ^ data received, or 
error 

An oscUlator completed a waveform 
lable 

Occurs every second 

A DeskTop Blls device requires 
service 

Power up, or ControJ-Apple-Rcset 
keys pressed 

Pcripberal'card reset, oc 
Conifot-Heset keys pressed 



( 



J 



Interrupt support 
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One of t±ie important <M(tcwnc^s 3>etwccn Lhc Apple IIGS personal 
computer and earUer models of the Apple \\ is that^ like ihe 

MactnLOfih, the Apple IICS has a byilt-in toolbox with routines that 
can be called by applJcaisons. The Apple 1105 Toolbox sen^'cs two 
purposes: It makes developing new applications easier, and it 
supports the desktop user interface. 



What is the Apple tlGS Toolbox? 

The Apple IIGS Toolbox is a collection of useful rouiines that can be 
called by application programs. The toolbox routines art: a 
permaffcent part of the system; they are available to applicaiion 
progfami? withOiH the need to Lnk libraries to application*. 

The tootboK routines have many uses. There are routines that 
support the new hardware features of ihc Apple IIGS, such as Super 
Hi-Res graphics and the Digital Osdllatcir Chtp CDOQ. Other 
routiriies suppcjrt the desktop user interi'ace, which uses mou-se 
Operations in menus and windows. 

The I'oolbox routines are arranged in logiGil groups called tooiMis, 
manngers, or simply loois. Each individual routine that can be 
called by an apptication Is a tool call. For cjcample, the routines that 
support the Super Hi-Res graphics display are in a tool set named 
QuickDraw II, and PaintPoty L* a lypical call in that tool set 

Not alL of the tools arc nJsiiJcnt in ROM; sonK2 of them are loaded 
from disk and reside in Ra\^T. The calling mechanism is the same 
regardless of where in memory a toot resides. A tool can even be in 
RAM in one version of the toolbox and in ROM in another version^ 
the application will run the same in either case. 

Developers are not restricted to the tool sets provided by Apple; 
they can create tool sets of itieir own 'Ilic Tool Locator provides a 
way to Switch back and forth between the Apple ITGS tool sets and the 
application's own tools. For information about creating a tool set, 
please read the manusl Appie HGS Toolbox Reference, Volurne 1. 
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Apple IIGS Toolbox compared 
with Macintosh 

Most of the rouiincs in the Apple IIGS Toolbox are similar lo 
routines in the Maciniosh Toolbox. In fad, ihe Apple IIGS 
designers started with the mosi important Maclmceh routines and 
tried to copy ihcm as closely as possible, considering ihe 
difFcrenoes between the machines. Much oF ihc work a typical event- 
driven application does lo support the user interface can be 
accomplished using the Apple llGS Toolbox. 



SlmilorEfies 

People familiar with the Madniosh Toolbox wit) find that many of 
the routines tn the Appte IlGS Toolbox are similar lo their 
Macintosh counterparts. Table 5-1 is st list of those Apple IIGS lool 
seis and the similar tool sets in the Macintosh. 

Tabto 5-1 

Macintosh counterparts for Apple Ites tool set* 

Appi« LtGS fool 9m\ MocJnIdsh IdoI tmt 



QuickDraw I[ 

SANE™ 

Desk Manager 

Event Manager 
Chigh-Ievel calls} 

Event Manager 
Oow-level calls) 

Menu Manager 

Window Manager 

Control Manager 

LineEdlt 

Dialog Manager 

Scrap Manager 

Print Manager 



QuickDraw 
Floating-Point Package 

Desk Manager 
Toolbox Eveni Manager 

Operating System 
Event Manjiger 

Menu Manager 

Window Manager 

Control Manager 

TextEdit 

Dialog Maniiger 

Scrap Manager 

Printing Manager 



Apple IlGS Toolbox connpcired wfth Macintosh 
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PfoDOS ]6 I& the disk opefotlnQ 
sysTenn. for fha Apple IIGS. So* 
ChQprer 5 tor a (iescrlptlon. 



Several other tool sets in the Apple lies Tootbox have functions 
similar to tool scLs in ihe Macintosh, but actually work quite 
diiTerenily. For example, the Tool Locator in Apple IlCS has the 
SAUK Functiori as the Trap Dispatcher in the Macintosh, but it's 
actually quite dirferent, Similarly, the Memory Manager in 
Apple llGS has the same job as ihe one in the Macintosh^ but deals 
with a memory space quite unlike that of the Macintosh, Other 
examples include the Apple IIGS System Loader, which is associated 
With ProDOS 16, and tlie Text Tool Set, used wih ihe text display, a 
Apple IIGS featupe that has no equivalent on the Macintosh. 



Differences 

While many of the routines in the Apple llGS Toolbox are simitar to 
their counterparts in the Macintosh Toolbox, they are certainly no* 
ideniical. The main reasons for the diflerenoes anc listed in 

Table 5-2 and cxplaned in the following sections. 



The Rfl-sourca Manager is a 
Mochofofih fool Tor editing dofa 
In programs without recompiling 
them, 



Toble 5-2 

Differences between the Apple Ites and the Macintosh 



Featur* 



Appl9 llsi 



Display 



Microprocessor 



Color graphics and 
text 

63C316, a descendaoc 
of Ihe 6502 



Memory orgamzaiion 64K meraofy banks 



Resource Maxiagicr 

TaskMasler 

Sound tools 



Part of Window 

Manager 

Sound Manager 



MoclnlosN 



Black-and- 
white graphics 
and text 

Saooo 



Continuous 

memory 

Part of todbox 
Not present 

Free-Form 
Sound Player 



DIsplovs 

The Super Hi -Res graphics display on the Apple TICS is supported 

by the QuickDraw II tool set, which provides many functions similar 
to those in the QuickDraw tool set on the Macintosh— similar, but 
not ideniicaL 
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TbQi a*p«cF raMo of on lmog<ei \& 
the foTlo qf Its width to Hi 
height. The standard' video 
dispidy ho3 a 4:3 aspect rotlo. 



One ma|Or difTercnce is iliai the Super Hi-Hes display has cptof, 
which the Mactniosh display doesn'L have. Another diJTerence is 
ihai ihe Super Hi-Res display is coarser: its highest resoluiion is 64Q 
X 200, compared wiih 512 x 342 for the display on the Macintosh, 
TJie aspect ratios of the pixels are also difFcrenL pixels in the 
MaciniDsh display are square, but pixels in ihe Super Ill-Res display 
are tall (aspect ratio 5:6 in 320 mode, ^:12 in 640 mode). If your 
Macintosh application includes the display dimensions as 
constants, you'll have to make appropriate changes to use the 
application on the Apple IIGS. 



Microprocessofs 

The microprocessors used in the two machines are entirely 

dirfercrtt. The 65C816 used in Lhe Apple IIGS has different 
insirucLionjs and addressing modes from those of the 68000 used in 
the Macintosh. The 65C816 has 16-bit daLa registers, while lhe 6SOOO 
has 32-bii registers. 



Memory orQonlzatlon 

Memory is organized dilTerenily on the two ntachirKs. Memory in 
the Macintosh is continuous, but memory in the Apple IIGS, though 
contiguous, is not continuous^ it is divided into 64K banks, with 
parts of some banks dedicaied to special lasks (such as display 
buffers and I/O devices), 

On the Apple IIGS, memoxy banks $00 and SOI arc broken up by 
several features needed for mnning programs wriiten for earlier 
vei^ions of the Apple II: the display pagcs^ the I/O space* and the 
language-card space. Also, there are differences in the way the 
65C8I6 microprocessor handles different banks. The Memory 
Manager on the Apple IIGS has to accommodate these restrictions. 

Tool sels 

The Apple IICS Toolbox doesn't have everything in it thsitl^ 
Macintosh Toolbox has. One tool set not found on the Apple IIGS Is 
the Resource Manager. You cun still put your program's constants 
and data simctures in a separate segmeni, but they won't be quite as 
easy for you to change. You'll need to be a ware of this difference 
when seuing up the segment with the items you might warn to 
change, such as icons and menu titles. 



I 
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On the other hand, the Apple TIGS has some tools Lhai the 
Macintosh doesn't. For example, the Window iManager on the 
Apple lies has a special call, TaskMasicr, lhai msikes ii easier to use 
the window environmcni (scg The section "Window MaLnager,"* later 
in this chapter). 

Another area where the Apple IIGS dilTers from the Macintosh is 
Lhat oF sound tools. ^Tiile the Macintosh has the Frcc-Fortn Sound 
Player^ ihe Appte IlGS has the Sound Manager, a low-level tool for 
conirolling the digital sound chip (the F.nsoniq DOC). 



Fof more Information about 
pr&grammlng on tho Apple 1K35 
compQied with me Mocinfosh^ 
refsf to the Pfogramm&f's 
tnif^ducttcf] to tn& Appi^ tiGS, 



Suggestions for programmers 

A ppSJ cations on the Apple IlGS have strong resembEances to 
applications on the Macintosh. They can have a similar desktop 
user interface, with menus and windov^'s which the user manipulates 
by using i. mouse. Programs on both machines can be event- 
driven, so their stnjctures can be similar^ wiUi a main event loop 
and conditional branches to the parts of the program that deal with 
each kind of event. 

To keep from being dependent on memory configuration, 
applicaiions on the Apple tlC5 use program segmentation and 
relocatable code. Unlike programs on die Macintosh, Apple IlCS 
programs arc not normany pdsition indcpendenE, but they can be 
lelocatcd by the System Loader. 

Programs wriwen in high level languages like C or Pascal on the two 
machines can be verjr similar. Programs or segments written in 
assembly language can also take advantage of the similarities 
between the Apple tlGS and the Macintash, but must be rewriucn 
because the machines use different microprocessors. The 
microprocessors have dilTcrei^t architectures and addressing 
modeSj so ihcy require different assemblers. 

^ iWoie.' Apple's assembler for ibe Apple TIGS Is not like the 
EdAsm assembler for ihe Apple II. The Apple IlGS assembler 
not only has the 65C8l6's additional instrucLions^ it also uses 
differcni macros. For more informadon about the assembler, 
see Chapter % 



i\i 
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Makfng calls to the toolbox 

Programs make calls lo individuat ffnniries in ihe Apple TIGS 
Toolbox by meaas of call names. The calting mechanism depends 
on the language of the program that is makirtg ihc call. For 
programs iji aiscmbly language, a macro libra ry defines ihe names, 
and programs make calls in the following fashion- 

1 . Push space for the result (if any) omo the slack. 

2. Push Lhe tnpui parameters onto the stack. 

3. Invoke the cait macro. 

4. Pull the result (if any) from the stack. 

For calls in higJi-lcvcl languages such as C of Pascal, there arc 
iibrancs ihat define lJ»e namc5 of the tool calls, along with 
appropriate coding conventions for |>a5Stng parameters on t!ie 
stack, similar lo the one defined above for assembly-language calls. 



The tool sets 

Here arc brief descriptions of the tool sets on the Apple IIGS. For 
compieTe descriptions, please ccfer to the manuals AppisIiGS 
7bolbox Rsfermtce, Volumes t and 2. Tool sets with related 
functions are gfoojpcd together: for example, all the tools that 
suppdJi the desktop inicrfaoe are together in the section "Desktop 
Tools." 



The big five 

These Ove tools — ^Tool Locator, Memory Manager, QuickDraw 11, 

Event Manager, and Miscellaneous Tool Set— make up the 
foundaiion of the toolbox. Your program may not call on ihcm 
directly, but other parts of the toolbox and of the opeiating system 
are heavily dependent on them. 



Tool Locotor 

The Tool Locator provides the mechanism for dispatching tool 
calls, ITianlts to the Toot Locator, tool sets can reside cither in ROM 
or in Ra\M That makes it possible for future versions of the toolbox 
to substitute enhanced tools in HUsM for tools presently in ROM with 
no changes to application programs. 

The too^ sets 63 



Developers need to me the Tool Locator only if ihey are adding 
their own tool seL* to the toolboK- Ihe Appie Hg^ Tooihax 
Mepretioe, Volume ] , tells how to do that. 

Memory Manog&r 

The Memory Manager conLTols y5C of memory by application 
programs. Keeping memory use under control of ihe Memory 
Manager makes ii possible to have co-resideni applications such as 
desk accessories 'Hie Sysieiti Ijoader calls the Memonr' Manager to 

request memory space for loading a program. 'I"he program has the 
option of making \\a own calls to the Memory' Mssniiiger to re<ruiest 
(allocate) additional memory^ release CdealUxate) memojry, or 
find otit how much memory is curFenity aii^ailable. 

QuickDraw n 

Tl-c .'ii:indard display for the desktop envsronmeni on the 
Apple I[GS Is d:ie new color Super Hi -Res graphics;, To support the 
graphics display, Apple nc5 nrmware includes a set of graphics 
roLiLLnes named QuickDraw 11. 

The graphics routins in QuickDraw II arc based on a subset of the 
Macintosh QuickDraw routines, 'lliey indude calls for changing the 

graphics cnvjrorimem and for drawing simple objects called 
pfirtutive obiecLs. The primitive objects QuickDraw 11 handEes are 

n lines 

D rectangles 

D legtons 
n polygorw 
U ovals 

Q rounded rectangles 

o arcs of drdes 

- pixel imagc^? 

a text characters and slrings 

QuickDraw II is important not onJy to graphics applicadons^ but to 
adl applicadons. that use the desktop intcrrace. bc^cay^ it includes 
the text-drawing calEs applicadons use for putting text into display 
windows on the desktop. 

In addidon to the drawing routines, QuickDraw II also has raudncs 
for performing calculations on different graphics objects^ for 
example, to determirM; whether a specified point is inside a 
particular rectangle. 
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Besides alt thai^ QuickDraw II also includes calls for dciining the 
global graphics environmenL (for example, setting color tables) 

and for defining portable graphics environments, called CrafpQn&, 
so that an application can keep track of several difTeient graphics 
aaivitles on differcni parts of ttije screen (or even in memory' that 

isn't being displayed). 

Evenf Monogef 

An event-driven application carries out iLs operations in response 
to mouse and keyboard actions by the user. The application 
program is organized around a main Loop thai contains a call to the 
E^-eni Manager followed by a series of conditional statements. 
These conditional statements determine the program's operations 
on the basis of the inforimatton returned by the Event Manager For 
example, pressing the mouse button generates an event, which the 
Event J^lanager reports the next time around the loop. The Event 
IWa nager also reports events within the application that may require 
a response. For example, changing one window may cause another 
window to become visibte and need to be redrawn. 

The Event Manager on the Apple UGS was designed to be as much 
like the evenL managers on the Macintosh as possibk:. Althpugh it is 
a single toot set, it has two kinds of calls, high-le^'ei! and the low- 
levet. that resemble calls to the Macintosh Toolbox Event Manag&r 
and Operating System Event Manager The Apple IIGS Event 
iManager detects low-levct events, such as presses of the mouse 
button, and stores ihem in an event queue. High-level calls retrieve 
events from the event queue and report events that aien*t kepc in the 
queue, such as ^'indt:3w c\'cnts. 

Mjscelfaneous Tool Set 

Tool calls in the Miscellaneous Tool Set include routines to perform 
sucli tasks as 

D accessing batter^' backed-up RAM 

U reading and setting the buili-in dock 

D accessing peripheral cards 

O changing the firmware inicmjpt vectors 

D installing and deleting tasks in the heartbeat interrupt queue 

n enabling or disabling some interrupt sources 

n accessing the mouse direclly 
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Deskfop tools 

These tooU — Menu Manager, Window Manager, Coriirol Manager, 
LineEdit, Dialog Manager, and Desk Manager — support the 
standard desktop Enierface. 



Menu Manager 

An application pro^^m sets yp menus and defines the menu bar by 

calling ihe Menu Manager. When the user gives a command, either 
from the meny using the mouse or by typing a command key, the 
application calls ihe Menu Manager lo find oui which comitiand 
IL is. 



Window Mdieiiiger 

Informatiort dispbyed by an appEicaifon program appears in 
windows. The application makes caJis to ihc Window Manager TO 
creaie windows, activate ihcm^ move Ihcm, change theif sizes, and 
close ihem. The Window Manager keeps track of overlapping 
window.* and posts events so the applicaLlon can mdraw wlndowi'S 
that are newEy uncovered. AlsOf when ihc application detects the 
event that happened when the user pressed the mouse button, the 
application calls the Window Manager to Und out whether the 
OJi^or wgis in the menu bar or a desk accessory or, if ill was in the 
windqfljv, whidi part of the window it ■^'as in. 

One of the calls in the Window Manager is TaskMaster, which is a 
kind of extended get-evcni call. A TaskMasiec cal! can handle many 
of the events that aje likely to happen in a window environmenL, 
such as mouse dicks in the control regions, without passing control 
back to the application. By using TaskMaster calls, a programmdr 
can get an application up and njnning quickly and Still take 
advantage of the features of the desktop user interface. 



Control Mcirvoiger 

A control is an object on the screen thai the user clicks with the 
muuse to cause an action or change a setting. Controls include 

obiecls such as buttons, check boxes, and scroll bar^. llie 
application creates and responds to controls by means of Calls to 
the Control Manager. 
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When the applJc^Lion has found out from ihe Window Manager ihat 
[he user pressed ihe mouse button in a window thai contaijis 
commls, It then calh ihc Contfol Manai^er lo find carry ou£ 
appropriate actions, such as 

n displaying or hiding a conirol 

D monitoring the user's opcraiion of a control 

a reading or changing the sening of a control 

D changing ihc size, locailon, or appearance of a control 

LJneEdit 

Application progmms accept tcxi typed by ihe user and perform 
standard ediiing fundions on the texl by means of calls ly UncHdiL 
lis functions are 

P inserting and deleting tC3ii 

a using the mouse lo seteci lext 

a culling and pasting tcxi 

LineEdtt provides basic Eext'dLsplay foimaiiing such a^ word 
wraparound. It handles only a line at a time, unlike the text editor In 
the MadniQsh Toolbox, which is a multi-tine editor 

Dialog Markoger 

The Diakiig Manager is a tool fifjr h.indnng dialog boxes and alerts in 
a way ihat is conjsistem with the Apple User Interface Guidelinca, 

Wlxcn an application needs more information from the u-^er aboui a 
comma nd^ it displays a dialog box. To alert the user in case of an 
error or a potentially dangerous situation, the application can 
display a bcjx with a message, cause a sound from the speaker, or 
both. To create and display dialog boxes, lo alert the user by a 
sound, and to find out the users responses lo ihc boxes and the 
soundSf the application calls the Dialog iManagcr. 

Desk Monomer 

The Desk Manager handles desk accessories, wly^h are small co- 
resident application programs such as calculators^ calendars, and 
the Like, The user can invoke a desk accessory while an application is 
runnings use the desk accessory for some task, then coniinue the 
application as if nothing had happened. 
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There are two kind* of ciesk accessories on the Apple llcs: cioisic 
desk acoessories ihat can mn either In the AppEe IIGS de:Sktop 
environmenL or with non-Appte Ii<j& applications Cike 

AppleWorks), and new desk accessories that run only in the 
Apple IIGS deskiop environ frwnL The Desk Manager checks lo see 
which environment it Is in and makes surt? ihai a desk accessory can 
mn in that environment before calling IL 

Two classic desk accessories are built in: the Control Panel that i$ 
used to change the machine conHgu ration and set the time and 
date, and the Alternate Dtsp3ay Mode (l^at is needed Tor 

applications that use both Lo-Res graphics pages. 



MalheinciflcQl tools 

The toQlbox has two dilTerent ways of handling numeric opeJ'ations; 
the SANE numerics, which provide comprehensive floating-point 
ariihmctjc, and the Integer Math Tool Set, which aie used by the 
oiher tool sets to perform integer arithmetic. 

Flootfng-poir^F numerics <SAMD 

Ihc Standard Apple Numerics Environment CSANE) is a 
scrupulously-conforming^ e:TLended-preci;siDn implementation of 
IEEE standard noating-point arithmetic. The Appie lies SAKE tool 
set was derived from ihe 6502 assembly tanguage SANE softw^are, 
and has ihe same runctions as the iMacintosh SANB packages. 
Features of the numeric tool set include 

D IEEE types single 32-biO, double C64-biO, and extended (SObEO 

o $4-bit type for exact nKed-poini computadons, such as in 

accounting 

D basic HoaLlng'point operations ( + - * + V rem ) 

D Comparisons 

p cnnversions between bJftary and dedmal or floaiing-pOEnt and 
integer 

D scanning and formatting for ASCII numeric Strings 

D Icgarilhms, exponentials, and trigonometric functions 

p compound intciest and annuity functions for finanda] 
computations 

P random number generator 

P functions for managing the floaling-pDlnt environment 

p other functions required or recommended by the IEEE standard 
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Integer Math Tool Set 

The integer math loot set indud^ several routines for working on 
data of types ifUegeK long integer, fixed, ind frac (that is, fraccional 
part). The functions of this too] set include muMplicatinfi. divislonj 
square root, some trigonometric functions, founding, and 
conversions between data types. 



Print Manager 

There is one loot set for dealing with prindng: the Print Manager. 
Refer to the Apple UGS Toolbox Re/ersnce, Volume 3, for 
inrormatjon. 



Specialized tools 

Ttie tool $et$ described in this section take care of specialized tasks, 

Sound Monager 

The Sound Manager controls both the single-bit sound hardware 

and the Digiial OsciUator Chip (DOO. It includes iwo sets of 
rouijnes: standard tool calls (called by way of the Tool Locator) and 
low-level calli Ccatled by way of a jump table) designed for faster 
access. 

By making tool calEs to the Sound Manager, an application can 

D $end sound data to and from the sound RAM 

n control ttie volume of the sound 

D Start and stop the sound from a paiiicular sound generator in the 
DOC 

~ get the status of any or all generators in the DOC 

n set up the sound interrupt handler 

n gpt the address of the jump table for accessing the iow-]cvel 

routines 

Usirig the low-level sound rouiines, an application an 

n read or write any regisDer in the DOC 

D read or write any location in the sound RANf 
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DeskTop Bus Tool Set 

Ttie Apple DeskTop Bujs C^DB) Tool Set provides a 

cominunicaLions and conLrol interface between your appticallon 
and ihc ADB mJcrDeonirollcr ihai operates Lhc DeskTop Bus. 
Besides the bus commanda, the ADB Tool Set tadydes catis used by 
diagnostic lautines and the Controt Panel. 

The ADB Tool SQi includes specific commands for the keyboard 
and the mouse. For other devices, applications need driver 
routines that set up the devices and handle their operation. The 
setup routines identify lhc different devices on ihe bus and may 
even change bus addresses and daia i:j.nvllers fojr them. 

The ADD Tool Set includes calls for pelling all the deviees on the 
bus. For rcpc^ated use of a sir^e devic<^, there is a polEing call thai 
always starts with the Ea^t device that was active. The application can 
use whichever polHng methnid is approprtate to conTinl the prior[[y 
of devices on the bus. 



To- be' Wnnfrdrrf, o fOkjHTr>g musf 
bo c^: 9 So accept a caU while 
one or mere or^vloys colia to It 
are pending wsthout Involldjartng 
arw previous calLi. 



Scheduler 

Much of the system code in the Apple ITCS is not reentrant. The 
Scheduler makes it possible [O tlchy the execution of tasks that 
require non-reentfant system code whenever that code i^ alieadv" In 

use. Non- reentrant resoufceis indicate that they are in use by 
modllying a Flag called the Busy word. The Scheduler maintains a 
queue of processes waiting to use non-itcntrant resources. By 
keeping track of the Busy word, the Scheduler detentiinia when to 
isctkvate ih& ncKi process in the queue. 



T#xt Tool Ser 

Like the other computei^ in ihe Apple 11 fimiliy, the Apple IIGS has 
a video display mode for text only. To use the lext-display firmware 
as earlier Apple II program.s do, program.? have to be nanning in 
emulation mode in bank SOO. llie Text Tool Set, along with the 
enhanced video output routines in the nrmware, makes it possible 
fcR" applications on the Apple IIGS to use ihe tej^t display wiihout 
switching environments and moving to bank SCO. 



m 



Chapter 5; Tb© Apple UGS Toolbox 



standard Fil« OperdlTons Tool Set 

The Standard File Opefations Tool Set provides ihc standard user 
interface for specifying a file to be opened or saved by an 
app]ia.don. 'When [he user selects Open or Sas'e in the File menu, 
the application calU the appropriate standard file operation, which 
op»ens a dialog box, dtsplays the files in tt« current volume, and 
handles user selection of files or options, such as sclcciin^ a 
difleient drive or ejecting a disk. 



Scrop Manager 

The Scrap Manager includes routines and data types that make it 
possible to cut and paste text or graphics tseiween two appUcatlonSp 
between an application and a desk accessory, or between two desk 
accessories. From ihe user's point of view, the data being cut or 
pasted resides in the Clipboard. 

The Scrap Manager keeps the data being cut and pasted In a block of 
mcmof>' called the desk scrap. The Scrap Manager can store it on 
disk if there isn't enough room for ii in memory. The type of data 
ixjing transferred is different for difl'erent applications, The Scrap 
Manager provides for difTercnt data types and provides some 
control over the amount of information that is retained when the 
scrap Is transferred. 
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The basic tdea behind, li^e Apple IICS archilicctiirc: i& to make a more 
powerful Apple 11 — one ihat can run program* designed for earlier 
models of file Apple II and also support more sophisiidatcd 
programs. The Apple IIGS achieves this contradictory-sounding 
goal by a combination of hardware and firmware — induding a new 
microprocessor, expanded memory^ improved video displays, 
and a new soyrtd generator— thai stJU ha* the ability to opcraie as an 
Apple IL 

The micropfooessor used in ihe Apple ITGS is the 65C8I6, a new 1& 
bit design based on the 6^02 microprocessor used in other 

Apple Ifs. The 6SC8I6 has two mafor fcaiures: 

n ii can operate either as a l6-bit processor or as an S-bit 6502. 
□ It can address to up to \6 megabytes of memory. 

The ability of the 65C9I6 to execuie 6502 instructions makes it 

possible for the Apple llGS to run programs designed to njn on 
6502'bascd models of the Apple II. Tlie 65<^l6's large address 
space makes ii possible for the Apple IlGS to have more memory 
than 6302-bascd Apple ll's. 



Figure 6-1 

Hypothetlcol Apple 11 
using the Mega II 
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This section descnbes ihe design of the Apple IIGS as a process of 
expansion, starting with ihe Apple II. Understanding a liitle about 
the way ihc Apple ]JGS evoK-ed will help you undefstand the 
rclaiionships between its new features and its old features. 



Starting point: the Apple II 

To understand how the Apple lies personal computer incorporates 
ihe features of the Apple IT, first consider the standard Apple IL 
Figure 6-1 is a simplified block diagram showing how an Apple II 
might be designed around Apple's Mega II integrated circuiL The 
Mega M is a custom large-scale iniegrated circuit that incorporates 
most of the timing and control drcuits of the standard Apple II. It 
addresses 12SK of RAM organized as 64K main and auxiliary banks. 
The Mega tt also provides the standard Apple II video display 
modes, both text (40-column and 80-column) and graphics G^o- 
Hes, Hi'Rcs, and Double Hi-Res). The slots indicated in Figure 6-1 
are like file ones on the Apple IIc; the ports are like the ones on the 
Apple lie. 
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Adding a foster processor 

Now suppose thai wc replace Ibc CPU with a new, fasicr 
microprocessof and add faster RAM and ROM and 4 new video 
display generator. Figura 6-2 is » sirnptified diagram of the result. 
Shading identifies ihe parts ihat proviilc ihc new features; generally 
speaking, ihc parts on the unshaded side provide ihe staniJard 
Apple II reaturcs. The CPU Is now the 65C816 on the shaded side; it 
operates in 6502 emulation mode when executing standard Apple 11 
programs. 
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Figure 6-2 

New hardware added to the Apple II 

The new CPU funs faster than ihc normal Apple TI processor — 
2.8 MHz, compared with the normal 1 MHz. To manage the 
disparate speeds, the new system has a custom integrated circuit, 
the Fast ProcesAor Inierface CFPI). that supports the faster memory 
for the new CPU and comtoh CPU access to the slower Mega U side. 
Besides controlling the fast RAjM and RC3M, the FPI also controls 
expansion RAM, up to eight megabytes of additional fast RAM. 



Th^ design process 
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The shaded side of Figure 6-2 also includes the Video Graphics 
ControUer (VGC). This integrated drcuit provides a new vidleo 
display, the Super Ill-Res graphics display. The new graphics 
display produces dear high- resolution color graphics on an RGB 
color monitor. 

Figuie 6-2 is misleading in one important respecL it implies that 
progfims designed For ihc standard Apple [I tun in the part of RAM 
conLrolled by ihe Mega U, which is not the case; such progcarfls 
actually run in ihe 128K of fast RAM on the shaded side of the 
diagram, The next section explains thai aspect of memory on die 
Apple Jlcs. 



Memory on the Apple IIGS 

The description of the Apple IIGS as merely an Apple n with a faster 

pFOoessor falls far short of the whole story. As Figure 6-2 shows^ 
adding the faster processor ncquiies adding faster memory. Besides 
thaL, one of the reason* for the new processor is not just iliat It runs 
faster, but that it can address more memory, making possible a 
significant increase in the amouni of memory on the Apple Hos. 
The following seciions tell how the larger, faster memory is 
implemented. 



Faster memory 

The Apple lies is capable of executing insLructions almast three 
limes as fast as a standard Apple II. That speed can be used in two 
different ways: to obtain faster execution oF standard Apple II 
programs, and 10 enable new programs to take Full advantage of the 

65C816 procesjsor, 

li*s important to rcalia^e that application programs — even programs 

designed for the standard Apple 11 — do not mn in the IZSK of RAM 
contrcjiled by tlie Mega II. That pan of RAjM always runs at the 
standard 1 MHz speed, because it contains the T/O slots and the 
display pages. The VO slots must be able to run Disk 11 controller 
caxds and other periphery I -card firmware with Liming loops 
designed to mn at tiK; standard I MHz speed. The display pages 
have to be synchronized with the video hardware, which also runs 
at 1 iMH^. The I/O and display features arc allocated to memory in 
high-numbered banks to keep the low-numbered banks available for 
fast RAM for running application programs. 
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The Fast Processor Interface (FPD handles addressing and memory 
fefresh for all of the RAM except the 128K controlled by the Mega 11. 
The FPl also handles ROM addi^cssing. Instniaion execution in 
those areas of memory runs at the rate of 2.8 MI it. Whenever the 
CPU needs lo read or write in the Mega Tl RAM (banks $E0 and 
SEl), ihe FPI synchronizes the CPU timing to match the 
Mega D's 1 Mliz clock. 

The user always has the option of using the 1 MHz speed for an 
application. (CPU speed is an option in the Control Panel) Note 
that the program is siJEI executing in the fast pan of RAM, but live FFI 
is operating at the standard speedL 



Memory shadowing 

For Apple U programs to run in memory banks $00 and $01, those 
banks must have the same features as the memory in a 128K 
Apple He or an Apple lie. That means they must include the 
language-card mapping in the area above SDOOO, the t/O spaces 
siariing at $C0O0, and the display buffers for the standard Apple IT 
displays. Here is a putzlc: To make the low-numbered memory 
banks avaltable as fast memory, the Appk: IIGS designers put the 
hardware for the I/O and the displays into memory banks SEO 
and SEl. Programs designed for the Apple U run in banks $00 and 
$01 Cas main and auxiliary memory), and don't address any other 
banks. How can such programs operate I/O and displays? 

♦ A'cile All I/O in an Apple II is memory mapped. Certain 
memory locations are attaclicd to I/O deviccSt and I/O 

operaiions are ju.Sit memory read and write instructions. 

The designers of the Appk; llGS devised a technique so that 
programs running in the fast part of memory (banks SOO to $7F) can 
operate the I/O and display features implcnrKinted in the slow part 
of memory (banks SEO and $E1). The technique is called memory 
shadowing, and here's how it works. When shadowing is selected for 
a specific area, the Apple lIGS hardware exeajies any instruciion 
that writes into that area of bank SOO or $01 by writing both there 
and into the same address in bank SEO or SHI. I3ecauj>c the memory 
in banks SEO and SEl is s>*nchroni2ed to the video hardware, the 
instruction must execute at the slow speed. 



Memory oo the Appie fiGS 77 



Display shadowing works a \li\le dincrcnily from T/Q shadowing. 
For I/O shadowing, boih reading and writing are slov-^ed down For 
display shadowing, the slowdown aflecLs only insirucLions ihai write 
in the shadowed arcasi [he CPU still mads from ihc display areas oF 
bankii 3O0 and $01 ai the faster speed. 

So LhaL cxisiing application programs will run on the Apple IIGS, ihe 
operating system lurns shadowing on whenever it loads an old-siyle 
apphcatlon, 



Memory maps 

Tlic memory maps in Figures 6-3 and 6-4 show the RAiM and HOM 
areas indicated in Figures 6-1 and 6-2, The 12BK of fast MM on the 
shaded side of Figure 6-2 corresponds to memory banks SOO and 
$01; the (fast) RAM on the memory expansion card begins irt bank 
$02 and can extend as high as bank S7F. 

The slow RAM controlkd by the Mega 11 corresponds to memoiy 
banks SHO and $E1, Those banks contain the video display pages 
and ihe memory locations allocated to the I/O expansion sl^xs. In 
addition, the buiU-in firmware also uses ItAM in banks SEO and $EL 

To give application programs full access lo the Jow-nunibered 
banks, the Apple JIGS designers allocated system memory in the 
high-nLimbered banks, "l^hc system ROM is in banks $l'E and SFF. 
System ROM includes Applesoft, the Monitor, built-in port 
firniware, and the ROM portion of the irxiEbox. Banks SPO through 
5FD are allocated to HOM on a memory expansion card^ which is 
used for additional system firmware and for applications stored as 
ROM Disk mes. 



Memory for sJondord Apple 11 programs 

The feaiLirc of the Apple llGS itiat makes it possible for it to mn 
standard Apple II programs is the implementation o( the standard 
12SK Apple It n>emory map in the 65C8l6's expanded memory 
£pace. This is done by configuring iw^o of tJie 64K memory banks to 
look like the FL-VM in a 128K Apple Re: banks $00 and $01, a^ ^ii!>wn 
in Figure 6-3. 
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fw^mory mop for standard AppI© fJ pro^ioms 



To make iwo meniory banks on Oie Apple II OS wart; like die main 
and ayxillary mcmQiy in an Apple ilc, those banks must have 
memofy shadcm'ing in effcci for I/O spaces and for the scandaid 
Apple 11 lext and gfaphics display pages. CThe Super Ili-Hcs 
graphics display is not a standard Apple U display and is noi 
normally uAcd with standard Apple 11 profirams.) 

When the user boots up a standard Apple II program on the 
Apple lies, [he firmware sets up memory banks 50f> and $01 as main 
and auxilEary memory, wtih language-card spaces, display butterSj 
and the UO space at hex SCxkx. The firmware also set? the direct 
page (Mcro page) and stack locatiDns to $CKX>0 and SO 100 in bank 
SOO. 

ProgfatTLS written for 6 bit Appk: Its don\ use RAM outside ihe 
main and auxiliary banks. To make addtitonal memory useful with 
such programs, ProDOS 8 uses the additional memory as a mass- 
storage volume named /RAiM5. 



MenfKjry lot new progmms 

New application programs written lo use the full capabilities of the 
Apple II GS don't have the re&triciions of progrants written for the 
standard Apple IL New programs can occupy memory in banks SOO 
and sot, parts of banks 5E0 and SElf and at! of the expansion RAM 
in banks S02 through $7F. TJic applications can call the Memory 
Manager to obtain addttiona] memory in those areas. 
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Memo<"y mop for new Apple fiGS pFogroms 



Figure fi-4 shows th& areas of memory availabJe to applications 
wriiten sped fiscally fof the Apple 11 GS. Noiicc ihat banks SOO aiT-d 
SOI siiSl have shadowins in I/O space and text Page 1. Those areas 
must be shadowed for proper operaiton of inierrupis and 
peripheral card^. Also notice ihat the cxpatision RAJVl (banks $02 
through $7F, if pcesenO is available as contiguous memory space, 

^ A nomindef: To ensure compatibiliiy wiih desk accessories and 
oihci" co-rcsiiieni routines, Apple lEGS applications that need 
addlLlonal memofy must rcqucsi it from ttnc Memory Manager 
GlJC System Loader calls ihc Memory Manager to obtain 
memory sj^cc needed for loading initiaJ program segments.) 
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The program enuimnmertt is ihc cornbinatJon of all of ihc aspect? 
of Ihe machine ihai affcci ihe operation of the program. Many of 
the things that make up the pfogram environment are nxed." for 
example^ [be fact that memory is addressed as bytes, or the fact Lhai 
all I/O is memory mapped, This chapcer describes those aspects of 
the program environment thai can be changed from one 
application to another. 



Environment options 

Programs running on itie Apple IICS personal computer will usually 
be of two basic ry'pesi programs that can also nin on B-bit 
Apple II's, and programs that can nxn only on the Apple IIGS. 
"While the environments for ihcKse two program types 51 re the ones 
used most often, they are not the only ones pt:jssib]e, and there is 
no single master switdi for changing frorti one to the other. Ilic 
program environment has many aspects, and programs can change 
any of them independently of the others. 

♦ Note: There are two operating systems for the Apple lies, 

corresponding to the two types of programs- ProDOS B for 8-bit 
programs^ and ProDOS l6 for l6-bii programs. Chapter S 
includes brief descriptions of the operating systems. 

The aspects of the environment that a program can change are 

D the microprocessor mode, register sizes, and values in banl« 
registers 

D the locations and sizes of the stack and direct page 

G the execution speed 

D Operation of the language card and I/O spaces 

a the dl^iplay memory spaces, including choice of displays and 
shadowing 

The following sections describe those aspects of the program 
environ me ni. 



1\^lcro process or options 

Several of tine conditions that arc dilTerent in the different 
environments are attributes of the microprocessor. Those Include 
the microprocessor mode, the register sizes, Lhe bank register 
values, and the locations and sii^ccs of the slack and direct pagie. 
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For more wiformoflon obout th# 
OfKKQTing modes of the fiSCSld. 
rerar lo tho manuaf Appfe iiGS 
HofOwofe RiJfsfence. ¥oy might 
(AiO wont to r&aci a reference 
IMC* obout ihQ 65CS16 Itself. 



Microprocessor modes 

The 65C816 mJcTopfocessor can operate in iwo difTercni modes: 
native mode, with all of iis new fciEiiies, and 6502 emuiatitm mode, 
for running programs written for 8-bii Apple 11 's. 

The 65C816 has Lhiee flags named e, m^ and x that programs use to 
control its operating modes. You put ihc 65CS16 into 6502 
cmylaiion mode by setting the e flag lo 1, W'hcn you do that, iht 
65C816 automatically makes the accumulatof and index registers 8 
bits wide. It also makes the stack only 256 bytes long, like ihc stack In 
il'Ki 6502. In emulation mode, the direcE page and the stack are 
automatically at locatioas SOOOO and $0100 in bank $00. 

Setting the e flag to puts the 65081 6 into native mode. In native 
mode, a pncigram can make ihe stack and direct page larger than 256 
bytes and can put them any^'hefe in memory bank $00. 

Register sizes 

In the 65C8l6 prcKe&sor's miive mode^ the wdths of the 
accumulator and index registers are conLroLlcd by the m and x flags. 
In the Apple lies, both the m and x Hags arc normally set to zero, 
making the registers 16 bits wide. Applications mnning in native 
mode can change either of those flags to make the accumulator or 
the indeje registers only 8 bits wide^ but there is normally no reason 
for an application to do so, even though some system routines work 
that way. 

'When running applications written for it^ the Apple HGS normally 
operates with l6'bit aecumutator and index registers. Wlien running 
8-bit Apple IE programs, the system switches the processor to 
emulation mode, which automa.tically forces the register widths to 8 
bits. On emulation mode, the m and x Hags have no eflea.) 

Bank register volues 

AppiicatJons written specifically for the Apple IIGS can use any 
banks tn memory by setting the program bank register and data 
bank register appropriately. '^Iien running S-bit Apple II 
programs, the system firmware sets both the program bank and the 
data bank lo bank $00, 
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stack and direct page 

Fof programs written for standard Apple Tl's, the staclc and dj;ec£ 

page musL be in their proper 6502 locaLiofis, and the stack miist be 
256 byscs long. For programs written specifically for the Apple JIGS, 
the sispe of tJie stack and tJie locations of the stack and dirtjct page 
within bank SOCl are at the discretion of the appltcation. 

'K'hen mnning the 65Cfil6 in native mode, you can locate the stac'c 

anywhere between 50BOO and IBFFF in bmk SOO. If you swit<^ to 
emulation mode, the processor aulomatieally sets ihe upper half of 
ihe stack pointer lu $01, %hcn you then switch back to native: mode, 
(he upper hilf of the stack pointer remains set 10 $01, and your 
origin at stack pointer Is lost- 

When you switch to emulation modc> you have to save your natjve- 
mode stack pointer temporarily, then set the stack potnter to the 
emulation-mode stack and push the native-mode stack pointer onto 
the emulation-mode stack. After doing that, you switch the 
pjiocessor to c mutation mode. To switch back frr^m emulaiion 
mode to native mode, you leveise the process: Fafst switch to full 
native mode^ then pull the native -mode pointer off the emulation- 
mode stack and transfer the 16-bJt value to the stack pointer. 

<K Note: Never use the main and auxiliary switches in native mode; 

doing so prevents the firmware tools from working propei'ly. 
When setting up the change From native to emulation mode, 
you have to use the emulation-mode stack in main memory, 
that is, bank SOO. 



Unporlanl You mtist alwoys have Enleriupts disabled vyhLjs y^>^ ^ra 
mclnlpylating the s-tock pointer. 



Execution speeds 

The microprocessor in the Apple TTCS can operate at either of two- 
clock speeds^ the standard Apple Tl speed, 1 MHk, and The faster 
speed of 2.8 MHz. For programs running In RAiM, a few clock cycles 
ate used for refpeshiing RAMf reducing the fast speed to an effective 
value of about 2,5 MH?.. System firmware^ njnning in ROM, runs at 
the full Z.fi Mliz, 



64 Cinapter?: Program Environm^ents 



f 



Control register! aro locatdd In 
!h9 I/O *poce CSCxxxJ In bonk 
SEO; they ard acc&ss!b«'e ffom 
bonk SOO If I/O ^cjdowlng In on. 
For more Inforrnatlon abouf the 
control registers, re-fer to tfie 



Thene arc three different ways of changing the operaiing speed. 
First, the user Gin use ihe CofiLrol Pane] lo set ihe speed Second, if 
a sJot has a Disk 11 conLroUcr card in it. the finnwajTe switches to the 
1 MHz speed whenever ih^i slcH is active, so that ihc disk conlrotler 
wilt work corrccUy. Third, programs can change the do<:k speed by 
changing the high bii of ihe Configuraiion rcgisLer, a cootrol 
r eg biter in tocation $C036. 



Language-card and I/O spaces 

Shadowing of the I/O and language-card sjpiciej is controlled by the 
lOLC Cl/O and language card) bit in the Shadow register, a control 
regisicr located at SC035 in bank SEO: see Table 7-1. The lOLC bit is 
nofirijlly set to zero, enabting I/O in. ihe $Ckxk space and mapping 
the 4K of RAM that would ordinarily occupy that space into a 
second bank of RAM in the SDkxx spicc^ as shown in Figure 7-1. 
"I'hat cofifiguration oFihc high i6k of RAM is called the langiiage 
card, after the first Apple 11 product that provided RAM memory in 
those iocations. 



RAM in $CxKif JB30CG 
SFFFF 
SFOOa 



SEaao 
SDDQQ 
SCOOO 



RAM mapped as ionQuago card 
SfFFF 
SFOOD 
SEOOO 
SDOQO 
$CDQO 











Bank 2 


&ank i 



F[guf«7-1 

Memory map of language-coid I^AM 



Impftcations for interrupls 

Part of ihc intermpt routines aie in ROM in the I/O space at $C07x. 
For that ROM code to operate, I/O mitsi remain enabled in Ihe 
SCxxx part of bank SOO and the high IfiK of RAM must stay mapped 
as a language card; tha[ is, the lOLC bit of the Shadow register muse 
be zero. If a program changes the tOLC bit so it can use RAM in the 
SCxxx -Space, the interrupt routines won't work. IQLC shadowing 
must be left on even by progfani? njnntng in nadve mode, which 
don't oihcrwi^je use the language-card mapping. 
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Standqrd Apple II display memory 

An ^ppircatiori running on the Apple IfGS can use any of the display 

modes avaJlabte on IWK. Apple ll's or the new Super Ilf-Res 
display. Of CQLirse, a typical applicalion will use onJy one or two 
display modes, so Jt can disable the nesL 

ApplicatiDns written for 8-bit Apple II's run In banks S^M" and $01, 
but ihe haidwaie For video displays use-^ niemory in banks $H0 and 
$El. For those applications^ ibc H mi ware sets shadowing on for 
those dii^play spaces, so that when the application writes into a 
display page in bank $00 or 5Cil, the hardware also WTites to the 
same location Jn bank S£0 or $E1. 

The program-selection routine in the Apple JIGS automatically sets 
[he display shadowing appropriaLcEy for the ope rating sysLcm that it 
is loading: on for DOS 3.3, UCSD PiseaL and PitfDOS 8, and oH 
for PfoDOS 16, When the stanup routine sets display shadowing 
on, it sets shadowing for all standard display pages. An application 
can turn off shadowing of individual display pages by setting 
individual bits in the Shadow register, as shown in Table 7-1. 

Tabis 7-1 

The Shadow f&glstsr (l&CQtlon $0035) 

»ir Function <1 - Inhibit) 

7 Cncscrvcd — mad undefined., must write zero) 

6 lOLC (I/O and language card) operation 

5 Cieserved^ — read undehned, must write zero) 

4 Auxiliary Hi -Res Pages 1 and 2 

3 Super Hi-Res graphics space 

2 Hi-Res graphics Page 2 

1 Hi-Res graphics Page 1 

Text Pages I and IX 
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Super Hi-Res display memory 

The Super Hi -Res display fe a new graphics display ihat has sesieral 
advantages over ihc standard Apple 11 displays. While ii5 Ewo modes 
have pesolution* iMi are oniy slightly higher than the resolutions of 
standard Hi- Res and Double Hi-Res, there is no a nierfere nee 
between adjacent colors, so Super Hi-Res di^sptays look much 
clearer than Hi-Rcs cw Double Hi-Res. It is aUo easier to program, 
because it maps entire bytes onto the screen, instead of just seven 
Wis, and its memory map is linear and continuous. Even though 
Super Ht'Res does cost a little more, occupying 52K of RAM, you'll 
probably want to use it anyway, because it Is supported by the 
desktop tools. 

Shadowing for Super Hi-R&s di&ploy 

The Super Hi-Rcs display uses locations S40O0 through SBFFF in 
bank SEl and Is normally not shadowed. An application can turn 
shadowing on and off for the Super Ili-Res display by means of the 
Shadow register. When shadowing is on for the Super Hi-R^ 
display, applications can write to il\at display space In bank $01 
(auxiliary memory). 

♦ A wminder Applicaiiorks that use the QuickDraw TI routines in 

the Apple IIGS Toolbox for their displays should have display 
shadowing off. The QuickDraw 11 routines write directly to the 
Super Hi-Res display space in bank $E1, so no shadowing is 
needed. 



Linear rr^emory map 

To make life easier for ihc graphics programmer, there is an option 

to make The addresses in the Super lii-Res display memor>' map 
onto the display in a simple linear Fashion. Bit 6 of the New-Video 
register controls the linear mapping opdon (1 to enable^ to 
inhibit). Of course, applications that use QuickDraw II don't have tp 
set the video control blis; QuickDraw U takes care of that itself. 

^ Nate: The linear-mapping option is not compatible with 
standard HI-Res and Double Hi-Hcs graphics. 
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♦ Apple !L Memory mapping in tJie standard display modes is of 
a byzantjjic complexity. First, adjacent rows qf dots Of 
character? on ihc screisn afe nol slored in adjacenl areas of 
memiOry, making [[ n*;ccssary for dispJay routines lo calcuEaie 
the $(afung location for each row, Also^ Hi-Kes graphics has the 
added handicap of T-bit byt&s^ that is, only seven bits of each 
bytfi are displayed. This mjkes ii harder for display routines to 
calculate [he address of a byte that corresponds to a position on 
the screen. Double Hi-Res es further burdened with the 
necessity to aitcrnate between memory banks when addressing 
adjacent locations on the screen. By using linear mapping, 
Sufx^r Hi-Rcs display routines avoid these problems, 

Tabia 7-2 

NowVldeo f&slstor (location $Ctl29) 

fill Function 

7 Enables Super Hi-Res graphics display 

6 Enables linear mapping for Super Hi-Res graphics 

3 Inhibits color in standard Apple II displays 

l^ Creserved) 

Efiabtes banit latch (used by s>'Siem) 



Mixing envFronmenfs 

Despite the profound diJTerences between the diiTereni program 
environments on the Apple IIGS, many operating features aie 

similar, h is therefore possible to enhance eKisting Apple II 
programs so that Ihey can take advaniaae of Apple IIGS features sudi 
as desk acoes^ries and program tools. 

Spedrically, the tootboit routines are accessible nol only from 
application programs written .specifically for the Apple IIGS, but 
also from programs njnning in 65^02 emulation mode. It Ls therefore 
possible ID modify existing 6^02 programs, adding toolbox calls so 
the programs can y^e The new features arnl the d[akiop user 
interface. (The tool sets themselves run in native modci 
applications njnning En emulation mode mu$t switch to native 
mode to make tool csills^ and switch back to emulation mode 
afterward.) 
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IL L5 even possible to make a hybrid prograni ihaL runs on either a 
6502-bascd Apple II or on s. Apple IlCS. by having ihe program 
check to see thai ii is runnmg on a Apple IIGS before iL makes any 
toolbox calls. 

A similar kind of compatibiliiy is available with desk accessories, 
which are accessible from standard App£e II programs running with 
ProDOS 6 or fxom Apple lies programs njnning with ProDQS l6. 
There are rwo kinds of desk accessories; classic desk accessories, 
which can ain in any Apple IIGS envimnmem^ and new style 6Gsk 
accessories, which can mn only under ProDOS 16. Each desk 
accessory has a flag thai determines which versions of ProDOS it 
can njn with, tn the sofiwaje hierarchy, the Desk Manager Is below 
PfoIX>S. '^'hen Ihc user invokes a desk accessory, the Desk Manager 
detects which vct^ion of HrorKDS it is tunning under and checks to 
see that the requested desk accessory c^n mn with thai version. 



Environment summary 

The simplest dLstinction between program environments on the 
Apple IIGS IS between the one iised for runntng programs wrttien for 
8-bil Apple irs and the one used for progratns wTiiicn specifically 
far the Apple IIGS. Tabic 7-3 ts a list of the conditions making up 
these two program cnvironmenis. VCliile it is possible for 
applications to set up other combinations, these two program 
envifonniHants are the only ones the firmware and tools support 



Table 7-3 

Apple IIGS pfogrpm environmehts 



Ftaluf* 



8-bEf Appr« W progirarrdi 



AppI* lliSS pfcgroms 



CPU mode 
Accumulator size 
Index register sisee 
Execution speed 
DirccL-page address 
Stack address 

Stack size 



Emulation Ce=D 
8 bits Ce-D' 
8 bits Ce-J)' 
lMirzor2.8MH2 

$0000 in bank SOO 
$01QO in bank $00 

256 bytes 



Native (c=0) 

16 bits Cm-Q 

16 bits Cx-0) 

2.8 MHz 

Any page in bank $00 

Any page from $0800 to SBFOO in 
bank $00 

Any size up to $B7FF 
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Toble 7-3 (continued) 

Appla lies program efwlronmenls 



Facrrur* 



A-bl( Appl« I) progmnu 



ApplA llt^jS progrcnTd 



Language-card .'ipaces 
in banks SCffi" and $01 

Shadowing of [/O spaces 
in banks $00 and $01 

Shadowing of lexl 
Pages 1 and IX 

Shad01^'^ng of Hi-Res 
graphic* pages 

Defauh dispby 

Atopping of Super Hi-Rej 
memory addresses 

RAM available lo 
application 



Use of expansion HAiM 

by appEic^don 

OperatJng system 



Yes 

Yes 
Yes 

Yes 

Text 

Normal, for Apple n standard 
displays 

Banks; $00 and SO] (plus expansion 

HAM and parts of banks SEO and 
$B1, if modincd Lo nin on Lhe 
Apple IIGS) 

As RAM Disk Cor via Memory 
Manager, if modified to njn on the 
Apple IIGS) 



ProDOS a, DOS 5 3. Of UCSD 



Yes 

Yes 

Yes 

No 

Super 1 [i-Res 

lii^ar, for Super Hi- Res display 

Thanks 500 and SOI, expansion 

RAiM , and parts of banks SHO 
and SEl 

As RAM Disk or via Memory 
Manager 



ProDOS 15 

PascaE 

*Irt cmulalian mode Cc-O, the mi and x flags are always e(Ted:Jvc1y cqUiaJ lo I. 



90 



Chapter 7: Prograin Environments 




Chapter 8 

Programs 

and the Apple IIgs 



9} 



Since iheir inccpiion, the Apple II computers have had buQt-jii 
firmware to support ipplicaLion programs, and the Apple II GS 
personal computer conLihucs and extends LhaL [radiiion. In the 
pa^ some appticaiions programmers have bypassed the firmware, 
taking direct conEiol of the system hardware. This chapter describea 
some of ihc ways this is done and some of ihe probtems thaL arise. 



Levels of program operation 

You Cifl think of the difTercnL levels of program operation on an 
Apple n as a hierarchy, with a hardware layer at the bottom, 
f[rmware and operating-system layers in the middle, and the 
application ai ihe top. Figure B-1 ilEustratcs this idea. Cihe 
hierarchy Ln Figure 8-1 ts a hierarchy of command 
levels — generally speaking, higher-level components call on lower- 
level ones.) 
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Program controf of the hard war© 

From the beginning, the Apple 11 has been an open machine. Not 
only has il been possible lo cxicncE t>ie hardware by means of 

peripheral cards in expansion slots, but programs have been able 
ID take control of ttic hardware independently of ihe built-iEi 
firmware. 
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^'henever the Hfrnware seemed too slow, appljaitioii programmers 
have ukcn the option of coniroLltng the hardware thomselvcs. As 
later inodcls of Apple U have incorporaied more flrmwaref ihc 

need for applications to do ii all for themselves has dLminLished. 
The Apple 13 GS has built-in program support far beyond that 
available on earlier models of the Apple II. Even so^ it is siill 
possible for a program to bypass the firmware and control the 
hardware directly. 

As Figure 8-1 shows, all of the levels except the 10T*t-si one are 
sortware — even firmware is only software that is permanchLly 
resideni As far as the hardware is concerned, one program is much 
like another, regardless of its origin. 

Every pan of the Apple IIGS, including the 65C8I6 microprocessor, 
control regisicrs in the custom ICs, ihe display buffers, and the I/O 
devices, is accessible to ihe application program. Many of the 
computer's function* arc controlled by soft switches^ which are 
mernory locations pjermanenily assigned to some hardware 
function. The soft switches are described in the j^k IIGS 
Hardware Reference. 

The phrase "programming on the hare rnetal" expresses the attitude 
of programmers who control the hardware themselves. That 

n^thod has the advantage that everything is done the way the 
programmer wants iL llie obvious disadvantage is that the 
programmer has to do a lot more work, taut a more important one is 
the increased likelihood that the resulting program will be 
incompatible either with other programs or with future versions of 
[he computer. 

In order to nin older programs that w^ere written with this approach, 
the Apple TIGS continues the Apple II tradition of hardware 
accessibility at the lowest level That makes it possible to program 
the Apple IIGS "on the bare metal.* It does noc make it advisable. 



Using the Appte II firmware 

The next level up from tt»c bare metal is the buflNn Firmware. In the 
earliest Apple II, this wa* little more than primitive I/O routines for 
handling input from the keyboard and formatting text output to the 
display .screen (in 40 columns only, of course}. The latest moctel 
Apple lie and Apple lie include more pt^werful firmware to handle 
the 80'column display, the mouse, serial I/O, and disk drives. 



levels of program oporoWon ^ 



Becayse ihere have been many changes from model lo model, it 
has generally been easier lo maintain compatibility with 
application programs that make use of ihe firmware interface, as 
compared wiih programs that control ihc hardware themselves. 
There is now a strong argument in favor of using the firmware, even 
when ihe progfammer Es dissalisfied with its performancCf jusi to 
minimize in compatibilities . 

A similar argument applies [o disk 0|Terations. In ihc past, some 
applications have set up their own disk file formats and ifsduded 
iheir own versions of DOS. Apple's new ProDOS for the Apple 1IG5 
is fast and powerful; the cost oF going your own way is now quite high 

compared with the advantages of staying compatible. 
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Chaptgr 5. "The Apple IIGS 
Toolbox,' ks on Introduction to 
tho tools. For mof© InformaMon 
about wrtt^g programs In this 
new way, you shouild rood 
Appfs SQS foD^bojc l^&ta/snce, 
Voiumes 1 and 2. and 
Programmer's IntroductiOff to 
th& Appto liGS, which do5cnbet 
the process ot putiing o 
program together. 



Using the Apple ITgs Toofbox 

The concept of a program toolbox is new to the Apple 11 family^ The 
Apple IlGS is the firiE Appie U lo have one. If you 3ie an 
experienced Apple II de%'eloper, even if you have striven to 
maintain maximum compatibility by ujsing only the firmwanG 
imerfaces that Apple has provided, you may find the loolbOK to be 
a new way of programming, From that point of view, the Macintosh 
developer may liave an easier time of it While the [oolbox is not 
the same as the one on the Madnlosh, it is sirnilij" in concept, and 
m^iny of it* functions are the same. 

The advantages of using ihc Apple lies Toolbox are many. Not only 
do ihe tools do a Icn of (he work that the application would oiherwUe 
ha^T^: to do, but the machine itself is set up lo use the toolii. 



Apple IIGS operoting systems 

Theie are three kinds of operating systems that can run on the 

Apple IIGS: 

D earlier systems sudi as DOS 53, ProDOS 1.0, and UCSD Pascal, 
which run the same way on the Apple IIGS as on odicr models of 
tlie Apple II 

D ProDOS 8, which mns on all current Apple n's and supports 
many of the new features of the Apple IIG5 

n the new ProTX>S for the Apple IIGS, ProDOS 16, which supports 
all of the new features but nina only on the Apple IIGS 
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The new PfoDOS for ihe Apple IIGS takes sidvantage of the l6-biC 
"insifuctions and large^ continuous memory space on ihe 
Apple IIGS, making jt yMblc lo nin on 64K and 128K ftiachines. To 
make U easy to distinguish beiv^iccn ihe two kinds of ProDOS, ihe 
PfoDOS thai njns on 8-bit Apple U's is H;:a]lcd />DJ%>SSand the 
ProDOS for the Apple IIGS is called ProDOS 16. 

ProDOS 16 Is funaionally similar 10 8-bti versions of ProDOS, but 
it does not work the same way^ so progran-LS that ain under an S-bit 
ProlX>S will not run under ProDOS 16 without suitable 
modificaLions. The latest version of 8-biL ProDOS, ProDOS 8, 
supports 8-bU programs mnning on the Apple tIGS. The System 
Loader automatically loads the appropriate version of ProDOS, 
depending on the ty^pe of siarfup file it finds on the boos: disk. 
Table 8-1 is a summary of the difTcjicnccs between ProDOS 8 and 
ProDOS :6. 

ProDOS a and ProDOS 16 compored 



F«atur« 



ProDOS a 



ProDOS \6 



Microprocessor made 
Minimum memory 
Maximum memory 
Memory management 

RAM Disk 

Memory pointer size 
System call instruction 
System file suffix 
System file type 



6502 emulation 
64K 

128K 

Bit map In global 

Connected 
2 byics 

JSR into bank SOO 
SYS 
SFF 



65C8I6 native mode 

256K 

8.25 megabytes 

Memory Manager 

Disconnected 

4 bytes 

JSL into bank SE1 

.SYSI6 

SB3 



Just rememborHiai ProDOS 8 is for 8-bit Apple IT applications 
mnning on the Apple IIGS, and ProDOS 16 is for Apple Jlcs 

applications. 

♦ Noie. Even though ProDOS 8 Vid ProDOS 16 are different^ 
they both use the same disk formats and file stnjctures. Either 
one can read a file written by the olher, except ihat ProDOS 8 
won't Stan up from the startup fika (type $B3) used for 
ProDOS l6f and ProDOS 1 6 won't start up from the system files 
ftype $FF) or binary files (type S06> used For ProDOS 8- 
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Apple ItGS ProD05 J6 RoforencB 
Includa* in'ormotion obouf thfl 
System Loader. 



The System Loader 

The Apple ncsS, Toa3box indudes the System Loader, i system 
pfogfam thil nukes full use of the large memory and. the 
standardized load modules on the Apple ITGS. The SysLem Loader, 
working in conjunction with PfoDOS l6 and the Memory Manager, 
loads and relocates program scgmenLs. Programs ean be compiled 
and linked as Individual segmoniSf some offli'hich can be loaded 
dynamically, as needed. 

Load segmen[s can be eiihci" sialic or dynamic Static segments 
remain in memory all during pmgram execution The System 

Loader loads all of a progiram's static segments when li first loads 
the program. 

'llic S>';;aem Loader doesn't load dynamuic segmenLs until they are 
called for during program execution. The program can rtquest 
specific segments by calling the System Loader, or ihe loader can 
U5e the segment jump table, which is a special segment set up by the 
linker to deal with references acnosi^ segment boundaries. 



Apple II compatlbilily 

One of the most impoitanit features of the Apple IIGS is its ability lo 
run standard Apple II programs. The Apple LIGS incorporates all 
the featufes of the Apple He and most a( the fcatuies of the 

Apple tic, including the abjliiy to suppon; either 5.25-inch or 3.5- 
inch disk drives connected to its disk port 



Running existing programs 

Users can bodi standard Apple tl program di^ks on the Apple IIGS 
and run most programs without modtncation. Such programs will 
not use any of the n^w features of the Apple IIGS except lis ability to 
njn 2.5 times as fast The programs will be running in 6502 
emulaQon mode and the memory Space available to them wiU be 
conEgured jusi like the IZBK of ItAM in an Apple Uc. 
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Users can Invoke the ControE Parw] desk accessory to change the 
I/O slot a^jgnmcnis to use with ihctr Apple II programs. They can 
aUo change the text display cokirs and Uie operating speed, Pof 
example, they'll probably want lo mn iheii business programs at 
ihc fast speed^ bul ihcy may warn to slow down to normal speed for 
games. 



Enhancing existing programs 

Even for progiams mnning In emulation mode, all of the new 
features of the Apple IIGS are available. The only trouble is that 
programs wfttKn for earlier Apple tl's don't indude routines that 
make use of the new features. As a deveEopc^^ you can modify your 
programs and add such routines while mainiaining compatibility 
with older models of Apple II. Modified programs can check to see 
what kind of Apple 11 they are running on and Lake advantage of the 
new features if they arc running on a Apple IIGS. 

♦ Note: To find out what kind of Apple II ihey are running on, 
programs can read the ID bytes at locatiorvs 5FBB3, $FBCO, 
and $FBBF in ROM. Assembly-language programs can execute 
a JSR (jump to subroutine) to location SFEIF in ROM, then 
branch on the state of the carry hit: It will be one for any 8-bii 
Apple II and zero for the Apple IIGS. For more information, 
refer to the Appie flGS Firmware Refetence. 

Of course, if you're going to modify an existing Apple 11 program, 
some of the new features make more sense than others. For 
example, changing jhe program to add routines that ojie the rwiw l6- 
bit instructions would require a lot of worft — work that would 
probahty be better spent on writing a new version of the program. 
On the other hand, modifying a program so it could use the built-in 
tools might be worthwhile. The decision should be based on 
whether the resulting program could still fit in memory on an 
Apple He or Apple lie If it couldn't, it would be belter to make a 
new version of the program just for the Apple llGS. 

Another way to make an application run on either an 8-bit Apple n 
or on a Apple llCS is to make a new version that nuns only on the 
Apple IIGS and put both versioas on a single disk. The appropriate 
version would run, depending on what kind of machine the disk was 
booted on. 'Ilw cold-sian routine on the Apple IIGS looks for a 
system file with the suOlx .SYS 16 and loads ProDOS 16 if it is 
present; an B-bil Apple II boots with a .SYS file and gets ProDOS 8. 
Refer to the Appk llGS PrvLKlS 16 Reference for more 
information. 
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The dcvdlopmcni cnvirtwimenE is ihe soriware that you idse for 

dev-cloping programs on the Apple ncs. The devetopnient 
envtraninent tndludes two kinds of programs- first, the Imguage 
compilers and assemblers, a.nd second, programs thai all 
dcvclopcra; use, rcgardJc^ of which languagic they aic using. Each 
compiter Of assembler has its own mafiual. The programs that are 
U-sed •With any of the programming languages are de^cfibed In the 
Apph IIGS PrografnYnef's Workshop ReferencB, 

Sevei*i] reatu«;s of the Apple lies help you with program 
development. First of all, there is a sLandard format for object files, 
regardless of their souroe. Then there are the linker and the System 
Loader that, together with smndard load Peles, make it possible to 
create modular programs with rclocaiabk segm^ints and lo 
oombarie segments written in diiTerent source languages. The 
la.nguages available on the Apple IIGS include assembly language 
and G. To provide a consistcni programming environment, there is 
the Apple IlGS Progfammef's Workshop iAP"^. Ttie workshop 
includes the operating shetl for contioEling the language compilers, 
along with the program editor, the debugger, the linker,, and utility 
programs. 



Program modularity 

The basis of the Apple HGS development environment is. the 
standard Tite formats. The standard formats make it possible to use 
many different pfogramrriing languages on the Apple lies. Along 
with the Sys^tem Loader, they aUo make pCKSSible program 
segmentation, with relocatable segments, that can be loaded 
dynamically during program executi.on- 

Cc^atlng a program is a mulEi'Slep process. First, the prDgram is 

wrinen. tn the form of one or more source files. Compilers and 
assemblers process^ tiie source nies and produce object files- The 
linker then takes the program object files, along with any 
appropriate library objiect files, and produces one or more load 
flics . It Is the load Dies that get loaded into memory when the 
program ts c?tecuicd. 
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Obf&c^ f[!e$ end load Hies 

Assemblers and compilers produce abjed files. The lim-ker 
com.bijniei& objca scgmcnLs from one or more object files and 
prodtices a load file. Sepdrace scgmcnis in object files can be 
combined into a jingle 5,egment by Lhc linker. Thai makes it 
possible Lo write the program as separate pans and recompile only 
liae a Reeled pan whenever you make a change. 

In addition lo ihe program object Hies, [here can be Eibrary dies 
containing general -purpose segments used by sclera! programs. 
The linker can search ihc library and extract the segments needed 
by the program. 

Each load nte consists of one or more segments, which can be static 
or dynamic. Static segments must remain in memory while the 
program ts running, but dynamic segmCnLS can be loaded and 
unloaded individually as they are needed. 

Program segments can also be rielocai;able. that is, capable of being 
loaded anyw.hcrc In memory^. The actual felodtlon is c^trried out at 
mn time by the SyHieim Loader. Each load segment contaiin* both 
lhc program code and a Felocation dictionary, which the System 
Loader uses [o recalculate addresses when ii Eoads relocatable 
segments, "Hie load file formal was designed to make dynamic 
loading as Fast as possible. 



Programming languages 

The Apple II GS development environrnent do«s not resyict 
dfiveioper* to a singJe programming language. You an use any 
programming language for which there is a compiler that produces 
object files in the Apple IIGS object module formaL The languages 
available from Apple include assembly language and C. 



Assembler 

The .^PW Assembler execules under the control of ihe APW Shell 

The assembler supports the Apple tIGS standard object file foimat 
and relocatable segmcrtts. 



Progtamffipr^ fanguogss \0^ 



A macro ai»ml3l*f con combina 
mutlple auemblv^cFngucigd 
tnslTuctlons Info ^ngle p^eydo- 
Inatru cti ons-- m ocf os— tnat 
make It easier to wrltD 
ossmbly-language proQrams., 

C^ndLtlctncil aiE«mb1y Is the 

OWIifV to aeiin^ magfOi Of Other 

pieces or code $uen ttict they 
pEsembl^ ditfergnfty under 
CfefTerent CDrtdillona. 



The APW Assembler is a full-feaiiired macro assenibler^ It 
SMppQits the Instfuctlon 5ets and addrsising mQdcs ofihe 65C816 
flitcfoprocessor. The assembler indudds 

D an extensive sei of assembler ctirectivies 

D macros and conditfonaJ assemhly 

D support for SregmentSr which can be either code or ^ti 

p partial assembly, so LhaL changes do not rdc^JTie reassembly of 
the entire program, 

D support for tibraty Hies that ihe linker seardies in case of 
unresolved references 

^ i\oi£.- The APW Assembler is no* a vcrsioji of Apple's PfoDOS 
Assembler Tools (EdAsm). 



C compiler 

The high-fcjvel language in Lhc Apple HGS Pfogramrrier's Workshop 
is G. Programs Tf^Tkien in C can easily include sections written in 
assembly tan^uagic and in Pascal 

APW C is similar to Mad niosh Workshop C. The Apple ncs 
Interface Library provides an interrace to the Apple IIGS Toolbox 
[h^t is funcUonilly similar to the ^<1ac]ntosh Interface Libraries. 

Thejie ar& a Pew difTeJienoes from Macintosh C, such as 

n The size of int variables is 16 bits. 

a The format of the pasca/ declaration is diFFenenL 

n FuncUon results are relumed in a global variablep rather than the 
Slack. 

D Begistef variables aee not available. 

I'he Apple HG^ Prc^mminer's Workshop C R^^ferencc includes 
dennLti:.!!'- tjf the C language and of the standard C library and The 
Apple TIGS Interface Libiary. It describes the diJTerenots beiwccn 
Apple IIGS C and a standard C: the Berkeley A2 BSD VAX 
implemcniaiion of the Portable C Compiler. 
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other compilers 

There can be t Apple HGS compiScr Tor almost any programming 
language- aU i^ compiler has tq do Is produce dbjea fi!^ 
compatible wiih ihc Apple IIGS object file formaL Languages for 
which compLlers could be wriaen include l^ascal, BASlC^ Fonran, 
Logo, Cobn^L and Lisp. 



Apple llGS Programmer's Workshop 

The Apple nc.5 Programmer's Workshop CAPVi^O Ls a set of programs 
that Apple provides to tnake it easier to develop applicaiiam for ihe 
Apple lies. The programs in the programmef 's workshop are 

D sheL] 

D editor 

a linker 

a debugger 

D utiEiiJcs 

These progranis are all described in die manual Apple JIGS 
Programmer's Worfeshop Refemnce. 



Shell 

The APW Shell provides the user Incerfaoe thai enables you to 

execute other APW programs and to perform viarjous housekeeping 
Funciions such as copying files. You type in commands in the old- 
fashioned way. 

The shell also acts, as an exlension to FroDQS l6, providing 
addttEonal suppon functions for programs sudi as compilefs^ 
assemblers, and linkers running under Ihe shell, lliosc fundlons 
include 

D parameter passing between programji and the shell 

D reading and sening ihe langiuagc type of a source fiEe 

D getting Tile names by using wildcards 

n passing control to other system pjx>grams 

□ moving^ copying, and dcledng files and subdirectories 

n renaming files 
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D changing prenxes 

D listing flt^s and directories 

n ctiangjiig the ProDOS fde type of a file 

The shdl suppons programmable command or tbtcc Tiles that can 
be used to eKecute any number of ahdt commands. The Exec files 

can include paramelcr passing and conditional execution 
jUTcmcnLS. 17je sheH also supports redinEdJon of input and output 
and pipelining of APW programs. 



Editor 

The APW Editor Is a text editor for use with the APW Assembler and 
compilers. To use the editor, you invoke it from the shell. If you 
select a pre-existing file fof editing, the editor is automatically set to 
the language of thai Hfe. Otherwise, the editor is set lo the tast 
language used or the last language selected with ^ shell command. 
You <^n also use the editor to acaie Exec Bits. 



Linker 

The APW linker reads object Hies created by the APW A^c^nfaikf or 
by the APW C compiler and generates load files. For lelocatjible 
code, the linker resolves external references and creates felocatjon 
dictionaries Because the asscmbleF and compiler create object 
nies that conform to the same format, the linker can link togeiher 
d>|ect modules created by any combination of APW languages. 

Norma tly, you cati the linker by a command to the shell that lets you 
specify a limited number of linker options. You specify parameters 
for segmentation amd printing in the source code Itself- 

For advanced programmej^ who need mofe ftexibOity than the l^nk 
command provides, the linker has a command language called 
linkEd You can use LinkEd commands to perform such functions 
as 

D extracting segments from object files 

D opening and closing output files 

n creating sialic or dynamic segment* 

n searching libraries 

D contioding printing by the linker 
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Debugger 

The APW Debugger enables you to irace pfogram exceuLron one 
instnicUon ai a ijme or run ful3 speed and slop at a breakpoint. Each 
Lime ihc program stops, the debufigef cLtspldys a dUassembiy of the 

code, ihe conienis of a specified area of RAM, and the oofttents of 

Lhe microprocessor's jregisiei*, stack, and direct page. 

The debugger can switch between its own display and the display of 
the program under test. 



Utllittes 

The programmer's ttrorkshop Includes several pfograms that 
perform functions that cannot be handled by the built-in shell 
comma fids. These programs are called utilities, and they indude 

□ Cfunchi compresses object modules after partial assernblies or 

compiiattons 

D Tnit; 'immUf£S d disk 

D MacGenj generates 3 macro file 

□ Maketib: generates a library Ble 

n DumpObj: lists aU lOu tines in an object module or load fmodule 

Some of the utility programs require no input from [he user other 
than the namei those programs are Lrcaied like any othef shell 
command and are referred to as exS&rnai commands. 
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Appendix A 



Roadmap to the Apple llGS 
Techinical Manuals 



Hie Apple lies pei^onal computer has many advanced features, 
making ii more complex than earlier models of ihe Apple IL To 
describe it fuUy, Apple has produced a suite of technical manuals. 
Depending on the way you intend to use ihe Apple llGS, you may 
need to refer lo a ticlcct few of the manuals, or you may need lo refer 
to most of them. 

The technical manuabi are lisied In Table A-T Figuns A-1 is a 
diagram showing the relationships among the djiffersnt manuals. 



Table A-1 

The Apple ll£55 technical manuols 



Tilt* 



$ubl«cl 



Technical Intmduction to the Af^fe Ucs 
Apple llGS Hardware Reference 
Apple HGS firmware Reference 
l^rogrammer's MroducHon to the Apple I fas 
Apple lias Toolbox Rqference, Volume 1 

Apple lies Toolbox Reference, Volume 2 

Apple IIGS I'rogrammer's Workshcp Reference 

Apple HGS Programmer's Workshop Assembler Reference* 

Apple lies Programmer's Workshop C Reference* 

ProDQS 8 Reference 

Apple lies ProDOS J 5 Reference 

Human Interface Guidelines 

Apple Numerics Manual 

There v> a pocket reference for cadi ofthesd. 



Viliat the Apple tIGS i5 
Machine internals — hardware 
Machine internals — Fifmware 
Concepts and a sample program 
How ihe toots work and somie toolbox 
.^pecifi cations 

More toolbox spc-cifi cations 
The dcvclopmeni envlroriment 
Using ihe APW Assembler 
Using C on the Apple ITGS 
ProDOS for Apple It programs 
ProDOS and loader for Apple IIGS 
Guidelines for the desktop inierfacti 
Numerics for all Apple computers 
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Pocket Reference 




Apple IIG5 
Firmware 
Reference 
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Introductory manuals 

These books are iniroduciory mantiaJs for developers, compLiler 
enLhusiasES, and other Apple IIGS owners who need technical 
informauon. As introductory many^l^JK their purpose is lo help the 
technical reader undcrsiand the features oFihe Apple tics, 
particularly ihc features thai are different from oLher Apple 
computers. Having read the introductory manuals, the reader wilt 
refer to specific reference manuals for details about a particular 
aspea of the Apple IIGS. 



The technical introducnon 

The Technical Introdttciion io the Apple IICS is the first book in the 
suite of technical manuals about the Apple IlGS. It describes all 
aspeOs of the Apple IIGS, including its features and general destgn, 
the program environments, the toolboK, and the development 
environmcni. 

Where ihc Apple UGS Ovmer*s Guide is sin introduction from the 
point of view of the user, the Technical Inimductkm describes the 
Apple I[GS from the point of view of the proj^ram. In other words, it 
describes the things the programmer has to consider while 
designing a pfogram, such as the operating features the program 
uses and the environment in which the program runs. 



An «varit-drlven progrprri Walls 
In □ "Dop unliS IT defegis an 
evenf sucn os a click or the 
mouse b*jMoo. 



The programmer's Introducllon 

^'hen you start writing progr^ixL'; that use the Apple IIGS user 
interface (with windows, menus, and the mouse), the 
i^grammer's Introduciion to the Apple llCS provides the 
concepts and guidelines you need, k Ls not a complete course tn 
programming, only a staling point for programmers writing 
applications for the Apple IlGS. It introduces the routines in the 
Apple IIGS Toolbox and the program environment they run under. 
It includes a sample cvent-drlvcn pfogram ihat demonstrates 
how a program uses the toolbox and Lfie operating system. 
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Machine reference manuals 

There are two reference manuals for the machine itselfi the 
Apple IIGS Hardware Ke/ermce and the Apple UCS firmware 
Reference. These books contain detailed jipe^incaiions for people 
who warn to know eietotly what's inside the machinCr 



The hardware reference manual 

The Apple IIGS Hanfware Reference is required reading for 

hartlwarc developers, and U wi]] also be of inter^t to afiyoi>e else 
who witiis lo know ho*- the madiine works. InrormaLion for 
developers includes the mcchanica] and electrical specifications of 
all connectors, both iniemal and exLcrnai. Ixiformation of general 
interest includes descriptions of the intenta] hardware, which 
provide a better understanding of the machine's features. 



The firmware reference manual 

The Apple IIGS Firmware Reference ^scnbes the programs and 
subroutines that arc stored in the machine's read-only memory 
CKOM). with two significant exceptions; Applesoft BASIC and the 
toolbox, which have their own manuals. The Firmware Reference 
includes information abcnJt in[ernjpt routines and low-]t^vcl I/O 
subroutines for the serial ports, the disk port, and for the DeskTop 
Bus interface, which controls the keyboard and the mouse. The 
Firmware Reference also describes the Monitor, a low-level 
programming and debugging aid for assembly-language programs. 



Th# toolbox manuafs 

Like the Mactntosh, the Apple lies has a built-in toolbox. The 
Apple lies Toolbox Reference, Volume 1. introduces concepts and 
terminology and telk how to use some of the tools. It also tells how 

to write and install yoyr own tool set. The Apfjie IIGS Toolbox 
Reference, Volume 2^ contaim information about the rest of the 

tools. 



The toolbox mar^uals TD9 



in app^ictitlcins fhor uia the^ 

comrnonds opp&pr Oi OfJtion* Sn 
Piij^-down m&riug, ond mffterlQl 
being worked on appear? In 
recta ngulor orgaj of th© sdr^on 
CQied windows. The u»r wiecta 
commands or other miairwlol Ipy 
Lislng the mouso to nova 
poimtG^ around on the ifCrean. 



Of cour^, y<xi dont have to use Ehe loolbox it all. IJ" you only want 
to wriie 5impte pmgrams ihaL don't use ihe nnouseH or windows, or 
menus, or other parts of ihc desktop user Interface, then you can 
get aEong wiihoui ihc icjoUxsk, However, if you are developing an 
applicailon thai u^es ihe desktop inierfaoe, or if you wani lo use the 
Super Hi-Res graphics display, you'll find the tootbo^t to be 
indispen^abte. 



The Programmer's Workshop manual 

Hie de^'cloprficnt environment on the Apple IIGS ts ihe Apple llGS 
Fj-pgommer's Work^shop (AP^O. APW is a set of programs that 
en-abte develnpef* to create and debug applicaiton progtanx^ on the 
Apple IlGS. Tfie Apple IIOS i^n>grammer's Woti^ship Refsj^nce 
indudes infonnaiion about ihe parts of the workshop that all 
developL'ra will u^. regardless which programming lan^iiagc ihey 
use: the shell, the editor, the linker, the debugger, and itie uliliiies- 
Ttie manual also tells how to write oifier prograrris. such a^ custom 
utilities amd compilers, lo mn under iJie APW Shell. 

The APW reference manual describes ttie wa^ yoa use the workshop 
to creaie an application and includes a sample program to show 
how thi5 is done. 



Programming-language manuals 

Apple is ourrenJy providing i 65C816 assembler and a C compiler. 
Other compilers am be used with the workshop, provided iliai tJiey 
follow the standards defined in the Apple lICS I'wgmmmer's 
Workshop RsfeTSTice. 

There l^ a separate reference manual for each programmiing 
language on the Apple lICS. Each manual indudes ihe 
spedfi cations of the language and of the Apple 1EG& libraries for the 
language, and describes how to write a program in thai language. 
The manuals for the languages Apple provides arc ihe Apple Has 
Programmers Workshop A^iembler Reference and the Apple HGS 
Programmer's WorHishop C Reference. 
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Operating-system manuats 

There aiie two operating systems thai run on the Apple IJCS: 
ProDOS 16 and ProDOS S. Each ojw- rating sysiem is described in iLs 
own manual: ProDOS 8 Reference and Apple llGS ProDOS 16 
Reference. ProDOS 16 uses the full power of the Apple IIGS and U 
not compatible with earlier Apple ll'S- The ProDQS 16 manual 
incEudes informatfon about the System leader, which works closely 
with ProDOS 16, If you are: wriilng programs for the Apple lies, 
whether as an application programmer or a system programiiKf, 
you are almosi certain 10 need the FtXiDOS 16 Reference, 

PfoDOS 8, previously just called PtvOOS, is compatible wiih the 
modelji of Apple U that use 8-bil CPUs. As a developer of Apple IIGS 
programs, ymi need to use ProDOS 8 only if you are developfrtg 
programs to mn on 8-bit Apple IFs as we!l as 00 the Apple IIGS. 



All-Apple manuals 

In addiiion 10 ihc Apple IIGS manuals menu'oned above, there are 
two manuaLs ihat apply to all Apple compuicrs: Hujnan Interface 
Guidelines 3.nd Apple Numerics Manual. If you develop programs 
for any Apple computer, you should know about ihosc manuals. 

The Human Interface Guidelines manual describes Apple's 
standards for the desktop interface of programs that run on Apple 
computers. IF you are writing an application for the Apple UCS, you 
should be familiar with the contents of this manual 

The Apple Numerics Manual is the reference for the Standard 
Apple Numeric Environment CSANE), a full implementation of the 
IEEE standard floaitng-point arithmetic. The functions of the 
Apple HG5 SANE too! set match those of the Madntcsh SAxNH 
package and of the 6502 assembty language SANE software If your 
application requires accurate arithmetic, you'll probably want to 
use the SANE routines in the Apple IIGS. The Ap^le Itas Tooibox 
Refet^nce icUs how to use the SANE routines in your programs. The 
Apple Numerics Manual is the comprehensive reference For the 
SANE numerics routtnes. A description of the version of the SAKE 
routines for the 65C816 is available through the Apple 
Programmer's and Developer's Association, administered by the 
A.P.P.LE. cooperative in Renlon, Washington. 

♦ Note.- The address of the Apple Programmer-s and Developer's 
Association is 290 5W 43rd Sliect, Renton, WA 98055, and the 
telephone number is C206) 251-6548. 
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I 



II 



Summary of Program 
Environments 



The simplesi disUnclion bciween program envkonmcfiis on the 
Apple ]]GS is between ihe one used for running programs written for 
8'bit Apple 1 1 's and the one used for progratns written specifically 
for ihe Appte IIGS. Tabic B-1 i^ a list of the conditions making up 
these two program cn^'ironnients. (Thts table ii a duplicate of 
Table 7-3. For more information about the program environmcnL, 
refer to Chapter 7.) 
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Toblo B-T 

Appla lies program environments 



F«ature 



A'bll Appl« II programt 



Apple IIGS programi 



CPU mode 


Emulaiion (e-1) 


Accumulator size 


8 biis (e-D* 


Index rcgtsicr size 


8 biis (e*iy 


ExccuLion speed 


IMHz or 2.8 MHz 


Pirca-page address 


$0000 in bank $00 


Slack address 


$0100 in bank SOO 


Stadc^Eze 


256 b>tcs 


Language-card spaces 
m banks SOO ai>J $01 


Yes 


Shadowing of I/O spaces 
in banks $00 and SOI 


Yes 


Shadowing of texi 
Pages 1 and IX 


Yes 



Shadowing of Mi-Rcs 
graphtas pages 

Dcf^uli display 

MappEng of Super Hi-Res 
memory addresses 

RAM available lo 
applicaLion 



Use of expansion RAM 

by application 

Operating system 



Ye-s 



Text 



Normal, for Apple [I standard 
displays 

Banks $00 and SOI (plus expansion 
RAM and parts of banks Sl£0 and 

$EI, if modified to run on the 
Apple IJGS} 

As RA-M Disk Cor via Memofy 

Manager, if modified to mn on the 
Apple liGS) 

ProDOS 8, DOS 33. or UCSD 
Pascal 



Native (e=03 

16 bits (m=0) 

l6bitsC«r=0) 

2.8 MHz 

Any page in bank SOO 

Any page from $0800 to $BF0O in 
bank SOO 

Any ^m up to SB7FF 
Yes 

Yes 

Yes 

No 

Super IIL-Rcs 

Linear, for Super HJ-Res display 

Banks $00 and SO^, expansion 
RAM, and parts of banks $E0 and 

SEI 

As RA.M Disk or via Memory 
Manager 

ProIX>S 16 



'In ^mulaibon mode C'fs^l)^ the m and x flags arc alwa^-s crTcct^'ely equal to 1. 
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I "This glossary defifije^ icchnlcal tefim used in ihis 
book. Boldfaced Lernis wiihm a dcfiniLion ane 
defined elsewhere in the glosttary-. 

accumulatort "l"he register In a computer's oenu-al 

processor or itiicroprooessor wtierc mosl 
conipuLaiions are performed. 

ACIA; Acronym for AsyTtchrDnoiis 
Communicaiions Interface Ad£0ier, a type of 
communication* IC used in some Apple 
computers other than \hc Apple Ties. Compare 

sec. 

acronycn: A word formed from the initial Ititjcrs 
of a name or phrase, such a^ ROM (from rvad- 
I only memory). 

ADO See analng-to-d{f^ta] converter. 

;iddrc!5s: A number ih^t specifies the location of a 
single byte of memory. Addresses can be given as 
decimal integers or as hexadecimal integers. A 
friK system has addres*ts ranging from to 65535 
Cin decimaO or from SOOOO to SFFFF (in 
liexadecimai). The letter xin an address stands for 
alt possible values for that digit- For example, 
$l>xxx means alt the addresses from SDOOO 
through $DFFl\ 

Americ^ui SimpliHed Keyi>oard: See Dvorak 
keyboard. 

American Standard Code for InfonnatJon 
Icitcrchangej Sec ASCII. 



ajiolog: (adp Varying smoothly and continuously 
over a range^ rather than changing in discrete 
jumps. For example^ a conventional 12-hour clock 
face is an analog device that shows the time of day 
by the coniinuously changing position of the 
dock's hands. Compare digital. 

analog RGBi A type of color video monitor thai 
accepts separate analog signals for the red, green, 
and blue color primaries. The intensity of each 
primary can vary continuousEy, making possible 
many shades and Lints of color. 

analog signal] A signal that varies continuousty 
over time, raiher than being .sent and received in 

discrete interval, Compare digital slgnaL 

analog to-digtial converter (ADC)t A device 

that converts quantities from analog to digital 
form. For example, computer hand controls 
cortvert the position of \hc control dial (an analog 
quantity) into a discrete number (a digital 
quantity) that changes stepwise even when the dial 
Is Cumod smoothly, 

Apple key; A modirkcr key on the Apple IIGS 
keyboard, marked with both an Apple icon and a 
spinner, the icon used on the equivalent key on 

some Madntosh keyboards. The Apple key 
performs the same functions as the Open Apple 
key on the Apple He and Apple lie 
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Applesoft BASIC The Apple U dialea of the 

BASIC progrartirsiing bngyage. An interpreier For 
creaUng and executing Applesoft BASIC programs 
is butU into ihe firmware of computers in the 

Apple IJ Family. 

AppleTalk networks Apple's local-area netwoffe 
for Apple II and Madntosh personal compute r$ 
and LaserWriter and ImageWriter 11 printers, like 
the Madmosh, ihe Apple lies ha* the ApplcTalk 
interface built in, 

ApplcTalk connector: A piece of equipment, 
consIstEng of a connection box. a short cable, and 
an B-pin miniature DIN connector, thai enables a 
Apple IlGS to be part of an AppleTalk network. 

Apple Ui A family of compuicrs, induding ihe 
original Apple Up the Apple 11 Plus, the Apple l[e^ 
the Apple Be, and the Apple IIGS. 

Apple He: A transportable personal computer in 
the Apple II family^ with a di-sk drive and iBO- 
eolumn display capability built in. 

Apple ne; A personal computer in the Apple l\ 
family with seven expansion slots and an auxiliary 
memory slot that allow the user to enhance ihe 
computer's capabiliiies with peripheral and 

auxilUry cards. 

Apple He BO- Column Text Cards A periphefal 

card that plugs into the Apple lie's ay miliary 
raemoiy slot and enables the computer to display 
lexi as either 40 or 80 characters per line. 

Apple ne Extended SO-Column Text Cardt A 

peripheral card that plugs into the Apple He's 
auxiliary memory slot and enables the computer 
to display text as either 4U or 80 characteis per line 
while extending the computer's memory capacity 
by 64K. 

Apple n Pa^cali A sofiwirc system for the 

Apple n family that lets yoM create and execute 
programs written in the Pascal programming 
language. Apple B Pascal was adapted by Apple 
Computer from the Universiiy of California, San 
Diego, Pascal Operating System (UCSD Pascal). 



Apple n Vlust A personal computer in the 
Apple II faiTiily with expansion slots that allow the 
user to enhance the computer's capabilities with 
peripheral and auxiliary cards. 

appUcation program: A program that enables a 
person to carry on some work, SMCh as word 
processing, data base management, graphics, or 
telecommunication. Compare system 
program. 

ASai: Acronym for American Standard Code 
for Information [nierchange, pronounced 
ASK-ee, A code in which the numbers from to 
127 stand for text characters. ASCII cotk is used 
for representing text ijiside a computer and for 
transmitting text between computers or betl^•een a 
computer and a peripheral device. 

aspect raiioi The ratio of an imagers width to lis 
height For example, a standard video display has 
an aspect ratio of 4;3. 

af^emblert A language translator that converts a 
pr<^ram written in assembly language into an 
equivalent program in machine language* The 
opposite of a disassembler. 

a<^enihly language: A low-level programming 
language in which individual machine-language 
instmalons are written in a symbolic Form that's 
easier to understand than machine language itself. 
Each assembly- language instruction produces one 
machine-language instruction. See also machine 
language. 

a&ynchrorious: Not synchronized by a mutual 
timing signal or dock. Compare syncbronoui. 

Asynchronous Cj^mmuntcatlons Iriterface 
Adapter: See AOA. 

auxIBary slot: The special expansion slot inside 
the Apple Be u.'sed for the Apple He 8Q-Column 
Text Card or Extended 80-Coiumn Text Cardj and 
also for the RGB monitor card. The slot is 
labeled AUX. CONTSIF-CTOR on the circuit board. 
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back panel; The rsar surface of the computer, 
which include* the pcwiir switch, the power 
connector, and cocinectora For periphetaJ 
devices. 

bauds A unit of dau [ransin^ion speed: the 
number of discrete signal state changes per 
second. Often, but not always, equivilent to bits 
per seamd. Compare bh rate* 

binary file: A Hie whose data is to be inierpfeted 
in binary form. Machine-language programs and 
pictufes are stored in binary files. 

bib A contraction of binary digU . The smallest 
unit of infonnaiion []v;ii ,i computer can hold The 
value of a bit CI or 0) represents a simple two-way 
dioice. such as yes or no, on or off^ postiive or 
negative, something or nothing- 
bit Imaget A collection of bits in memory that 
have a rectilinear graphical representation. ITic 
display on the screen is a visible bit image. 

bltmnp: A set of bit* that represents the pasitions 
and states of a corresponding set of items; for 
example, dots in an image. See bJt ifnuge. 

bk rate: The speed at which blLs arc tiansmiticd, 
usually expressed as ti& per second, or tps, 
Connpaie baud. 

block I/O device: A type of device that reads or 
writes information in organized groups called 
blocks, which are typically 512 bytes long. A disk 
drive 15 a block device. 

boott Another way to say start up. A computer 

boots by loading a program into memory from an 
external .stor^ige medium such as a disk. Boot is 
short for bootstrap load, a term suggestive of the 
difnculty of initial loading of loader programs into 
early computeni that didn't have built-in firmware 
in ROM. 

bootstrap: See booC* 



buffer: A holding area in the computer's memory 
where information can be stored by one program 
Of device and then read at a dilTcrent rate by 
another-, for example, a print btilTer, 

bugi An error in a program thai causes It not to 
work as iritendcd. The expression reportedly 
comes from the early days of computing when an 
itinerant moth shorted a connection and caused a 

breakdown in a room-size computer 

husi A group of wires or dxcuits that trammit 
related infomiation from or^e part of a computer 
System to another. In a network, a line of cable 
with connectors linking devices together. A bus 
network has a beginning and an end. Gt's not in a 
closed drcle or T shape.) 

buttons: The pushbutton-like images in dialog 

boMcs where you dick to designate, confirm, or 
cancel an action. See also mouse button. 

bytei A unit of meajsure of compiLier data or 
memory, consisiing of a fixed number of bits* 
On Apple II systemSf one byte consists of eight 
bits, and a byte can have any value between and 
255. The value can represent an instruction, letter, 
number, punctuation mark, or other character 
See also kilobyte, megabyte. 

calL Cv) To request the execution of a subroutine, 

function, or procedure, (n) A request from the 
keyboard or from a procedure to execute a named 
procedure. See procedure. 

carriage returti: An ASCII character (decimal 15) 
that ordinarily causes a printer or display device to 
place the next character on the left margin. 

carry flag: A status bit in the microprocessor, 
used as an additional high-order bit with the 
accumulator bits in addition, subiraaion, 

rotation, and shift opeiations. 

cathode-ray tube: A display device, 

centra proces^slng unit (CPlDt The part of the 
computer that performs the actual computations 
in machine language, See al^o microprocessor. 
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chaf^acter: Any symbol th^t hzs a wIdJely 
undei^tochd meaning and ihtis can convey 
informatioEi. Some characiers — ^such as IcLtcrs, 
numbers, and punctuaiion' — can be displayed on 
Lhe moniior scneen and primed on » printer, 

chJps Sec integrated drojJt. 

cLrcuJt board: A board conLaining embedded 
circuJLs and an aLiached callecLion of integrated 
circuits (chips). 

dock cbi[p3 A speciti chip in whtch p^r^n^eter 

RAM and the ojjfent setting for the date and time 
are stored This chip is powered by a battery when 
the system Is oFT^ thus preserving the Lnrormalion. 

dose: To turn a ^window back into the icon that 
represents iL. 

QbfOS: Abbreviation Tor comp!em&ntaiy metai 
oxide sflfcon, one of several methods of making 

inccgrated eircyits out of silicon. CMOS devices 
are chaj^ctefiaed by thdt low power 
consumption. CMOS technique^ are derived from 
MOS techniques. 

code: (1) A number or symbol used to represent 
some piece of infonnation. (2) The statements or 
instnjctions that make up a pn^gram. 

cold start: The process of siarting up the Apple n 
wtien liie power is fijsl turned on Cor as if the power 
had just been mmed on) by loading the operaUng 
system into main memory, and then loading and 
running a progranL Compare boot, Tvarta start. 

column: A vertical arrangement of graphics 
points or character positions on the display. 

commajid: An instmction that causes the 
computer to perform, some action. A command 
can be typed from a keytward, selected from a 
menu with a hand-operated device (such as a 
mouse), or embedded in a program. 



comp^erf A language tianslalor that converts a 
program written in a high-level program ming 
language (source code) into an equivalent 

pfogram In son^ lower-leii/el language such as 
machine language Cobject code) for later 
eJtecution. 

f^mponent: A part; in particular, a part of a 
computer system. 

composite video: A video signal that includes 
both display infonnaiion and the synchronisation 
Cand other) signals needed to display it Also 
called m^SC vidm. Compare RGB. 

Cf^mputer; An electronic device that per^Hltift 
predefined Cprogrammed) computations at high 
speed and with great accumcy. A machine that Is 
used to store, transfer, and Lransform 
Information. 

computer languages See program.m{n^ 
language, 

condJtJDnal assembly: A featun; of an assembler 
that allows the programmer to define macros or 
other pieces of code such that the assembler 
assembles them dilTerently under different 
conditions, 

CDodJUonaJ brandi: A type of branch instrudion 
whose execution depends on she truth of a 
condition or the value of an expression. 

ConfTguratton: (1) The total combination and 
arrangement of hardware components^-CFUj 
video display device, keyboard, and peripheral 
devices— that make up a computer system, <^ The 
sortware settings that aUaw various hard^^'are 
components of a computer system to 
Communicate with each other. 

Control kej': A specific modifier key on Apple H- 
family keyboards that produces control characters 
when used in combination with odner keys. 

Control FaneL A desk accessory thai lets you 

change cenain system parameiers, such as speaker 
volume, display colors, and configuration of slots 
and ports. 
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control regtsterss Special registers ihac 
programs cm read and write, similar lo soft 
switches. The conirol registers are speciHc 
legations in the I/O space (SCxxx) in bank SEK)-, 
ihcy are acoessibk Trom b^nk $00 if I/O shadowing 
is Ckn. 

Control-Rcscti A combination keysLroke on 
Apple Il-ramjly compuicrs thai usually causes an 
Applesoft BASIC program or command to Stop 
immediately. 

controller caitL A peripheral card ihat connects 
a device such as a printer or disk drive to a 
computer's main togic board and controls the 
operation of the device. 

CPU; See central processing wnit. 

cursoR A symbol displayed on the screen 
marking where the user's next action will take efiect 
or where the next character typed from the 
keyboard will appear. 

DAO See dJgltaKto-an^og converter. 

data: irtformaiion transferred lo or from, 
or stored in, d computer or other mechanical 
communications or storage device. 

dat^bits: The bits in a communication transfer 
that con^iin information. Comp^arc start bit, 
itop bit. 

data formats llic form in which dam Is stored, 
manipulatedp or transferred. For example,, when 
data is transmitted and iticcived serially, it 
typically has a data format of one stan bit, five to 
eight data bits, an optional parity bit, and one or 
two stop bits. 

Data Carrier Detect (DCD)j A signal from a DCE 
(such as a modem) to a DTE (such as an 
Apple 11 GS) indicating that a conununicaiion 
connection has been esiabiishcd. See Data 
Communtcatton EqulpmeAt^ Data Terminal 
Equipment* 



Data CoouDunlcatlon Equipment (DCE): A^ 
denned by the RS'252-C standard, any device that 
tfansmlts Of fcceivcs information. Usually this 
device is a modem. 

Data Set Ready (DSR): A signal from a DCE to a 
DTE indicating that d^e DCH has csublished a 
connection. Sec Data CommunJcation 
Equipment, Data Terminal Equipment* 

Data Terminal Equipment (DTE): As defined 
by the RS-232-C standard, any device thai 
generates or absorbs information, thus aaing as 
an endpoint of a communicaiion connection. A 
computer might serve as a DTE, 

Data Terminal Ready (DTR): A signal from a 
DTE to a DCE indicating a readiness to transmit or 
receive data. Sec Data Communication 
Equlpmenti Data Terminal Equipment. 

DCDs Sec Data Carrier Detect 

DC£: See Data Communlcailon Equipment 

debug; A colloquial term that means to locate and 
correct an error or the cause of a problem or 
malfunction in a computer program. See also bug^ 

delaulti A preset response lo a question or 
prompt The default is automatically used by the 
computer if the user dtsesn'i supply a different 
response. Default values prevent a program from 
stalling Of Crashing if no value Is supplied by the 
user. 

delete; To remove something, such as a character 
or word ffiom a filc^ or a file from a disk. 

Delete keyt A key on the upper-right comer of 
the Apple He, Apple lie, and Apple IICS 
keyboards that erases the character immediately 
preccdiog (to the left oO the cursor. Similar to the 
Madniosh Backspace key. 

delta guldet A description of something new in 
terms of its differences from something the leader 
already knows about. The name comes from the 

way mathematicians use the Greek letter delta ( A ) 
to represent a difTerenoe, 
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desk accessorlest 'Mini-applicaiLions" that a,re 
avaiEablc From [he computer's menu regardless of 
which appEJoitJon yoy'ne using. The Contxol Pafid 
i£ an ejoimple of a desk acoessary. 

desktops Tbe vLs^ual interface between the 
cojnputef and the user — the menu bar and the gray 
area on the screen. You can have a number of 
documenli on the desktop at the same dme. 

desktop envlronjnentr A s^i of program features 
tha.t make user interactions with an application 
resemble operations on a desktop. Commands 
appear as options in pull-down meniiSt and 
mi^ceda.! being worked on appears in areas of the 
screen called wlodo'WB. The user selects 
commands or other matcnal by using the mouse 
to mrove A pointer around on tJie screen, 

desktop tiser interface: See desktop 
environ menc. 

device driven A program that manages the 

transfer of information bctwocn the Computer and 
a peripheral device. 

diglli CD One of the chaJi,tilers through 9, used 
to express numbers in decimal form, (2) One of 
the characters used to express numbers in some 
other form, such as and 1 in binary or through 

9 and A through F in hexadecimal, 

digital; Cadj) Represented in a discrete 
(noncontinuDus) form, such as numerical digits or 
Integers. For example, contemporaiy digital 
docks ^ow the time as a digital display Csuch as 
2:57) instead of using the positions of a pair of 
hands on a dock face. Compare anjalog. 

Digital Oscillator Chip CtlOC> an integrated 
drcuit that contains 52 digital oscilSators, each of 
which can generate a sound from stored digital 
waveform data. 

digliaJ sigrtaL A signal that is sent and received in 
diserete intervals. A signal thai docs not vary 
continuously over time. Compare analog signal 



dJglfal-to-Anatog converter (DAO A device 
that converts quantities from digital to analog 
form, 

DIN; Abbreviation for Deutsche Indusirie 
Nortnal a European standards organization. 

DIN connector; A type of connector with 

multiple pins inside a round outer shield. 

DIP: Sec dual £xi-Uiie package. 

direct pag^. A page C256 bytes) of irKmory in the 

Apple IIGS that woriss like the zero page in a 6502 
system but can reside anywhere in bank $00, rather 
than always starting at location $0000. Co^ resident 
programs or routlrtes can hove their owo direct 
pa^es at dJETerent locations. 

directory] A Hie that conialns a list of the names 

and locations of other QLes stored on a disk. These 
othef nies may themselves be di rectories CcalEcd 
suMir^iorimJ. A directory is sometimes called a 
catalog. 

disafisembEer^ A language translator that 
converts a machine-language program into an 
equivalent program In assembly language, which 
is easier fof programmers to undeistand. The 
opposite of an assembler, 

dUk-based: See disk-resident, 

disk controller card: A periphefal card that 
provides the connection between one or two disk 
drives and the computer. CThts connccdon, or 
interface, Is built into the Apple lie, the 
Apple tics, and all Macintosh-family computers,) 

disk operating systems An operating system 
whose principal function Ls to manage fUes and 
communications with one or more disk drives. 
DOS and ProDOS are two disk operating systems 
for the Apple U. 

djsk- residents A program that docs not remain in 
memory. The compuEcr retrieves all or pan of the 
progj^m from the disky as needed. Sometimes 
called disk-based, Compare memory-resident. 
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Disk D dflve: An older type of disk dtiv^ fnade 
and sold l?y Apple Computer for use with tiie 
Apple II, II PUis, and lie. It uses 5.25-inch floppy 

disks. 

display: (1) A genera] lerm lo describe what you 
see on the screen of your display device when 
you're using a computer, (2) Short for a display 
device. 

display devices A device that displays 
informaLion, such ^s a. iclcviSiion set or video 

monitor. 

diihertng: A technique for stltcmating the values 
of adjacent pixels to create tlte ffrcci of 
interrncdiaic values. Dithering can give the cfTcci 
t>l' shades of gray on a black-and-whiie display, or 
more colors on a color display. 

DOO Sec Dlgltxil OsctUatar Chip, 

DOS; See diffk operatlniE system. 

DOS 3.3; An Operating Kystem for the vVppJe Tl 

family of cornpu[Crs. DOS stands for Disk 
Operating Sy^temi 5.3 i* the version number. 

DSRi See Data Set Ready. 

DTEj See Data Terminal Eqiiipim-nt. 

DTRi See Data Terminal Ready. 

dual In-line paclmge: A type of integniicd circuit 

package tJiai i.^ rn^voangular and has a row of 
connector pins along each side. 

Dvorak keyiH>ard; An alternate keyboard layout, 
also known as the Amencan Simplified Keyboard^ 

which increases typing speed because the keys 
most often used are in the position.? easiest to 
reach. Compare QWERTY keyboard. 

edit! To change or modify. For example, to 
imeri, femovCi replace, or move text in a 
document, 

editor^ A program that helps you create and t.:di[ 
information of a particular form, for e.Kample^ a. 
text editor or a graphics editor. 



elTectrve addresiSt tn machine-language 
programming, the address of the memory' 
location on which a particular insirudion 
operates, which may be arrived ai by Indexed 
addressing or .-isome other addressing method. 

e flag: C3ne of three flag biis in ilie 65C8t6 
processor that programs u.?e to control the 
ptocessor's operating modes. The setting of tJ-see 
Qftg determines whether the prooessor is in native 
mode or emulation modt;, See also ni fUig, x flag, 

frblt Apple 11: Another way of saying standard 

Apple II, that is, any Apple II with an 8-bit 
microprocessor (6502 or 65C02), 

SO-ct>lumn text card^' A peripheral card that 

allows the Apple II, Apple II Plus^ and Apple lie to 
display text in 80 columns (in addition to the 
standard 'iO columns). 

emulaiet To operate in a way idenrical to a 
diffeient system. For example, the 65C816 
microprocessor in the Apple llGS can carry out all 
the instructions in a pfogfarn origin illly written for 
an Apple 11 that uses a 6502 niicroproccssor. thus 
emulating the G502. 

emulation modes A itiiplier of operating In 
which one system imitates another. In I he 
Apple lies computer, the mode the 65C816 Is in 
when the Apple IIGS is running progrsms written 
for Apple \Vs that use the 650 Z. 

Escape character: An ASCII character thai, with 
many programs and devices, allows you to 
perform special functions when used in 
combination keypresses. 

Escape keyt A key on Apple 11-family computers 
that generates the Escape character. The Escape 
key is labeled /Itc. In many applications, pressing 
Escape allows you to return to a previous ftienu or 
to stop a procedure. 
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eyen p^rltyt In data transmisslDn, ihc uso of in 
exiia bit set lo or 1 as neoessary to make ttie total 
number of 1 bits sm even number ^ u^ed as a meafis 
of error checking. Compare MARK parity, odd 
parity. 

event-dflven: A kind of pfogfam that responds to 
user inputs In real Lime by repeaitedly testing for 
events posted by interrupt rouUnes. An evcnl- 
drjvdn program docs nothing until It detects ^n 
event such as a dick of the moMse buuon, 

expansion slot; A socket into wi^ieiii you can 

install a peripheral card. Sometimes called a 
periphenmi slot. See also auxlUauy sloL 

Extended dO-Cohunn Text Card: See 
AppEc Hi' Extended BD-Column Text Card. 

Die types In a directory listing, the code that 
character! i&i the contents of a rite and indicates 

Ivow the rJe m^y be used 

nrmware; Programs stored pcrmaneiU^ in read- 
only memory (ROM)^ Such programs (for 
eKample, the Applesoft Interpreter and the 
Monitor prograEii) aro built into the computer at 

the factory. They can be cMccuicd at any time but 
cannot be m<xiifie<i or erased from miain 
memory. 

fonb In typography, a complete set of type in one 
jitze and style of character. In computer usage^ a 
collection of letters, numbers, punctuation marks, 
jind other typographical symbols with a consistent 
appearance. 

formats (n) The form In which infontiation is 

org;anized or presenieeL (v) To divide a dusk into 
tracks and sectors where information can be 
Stored. Blank disks must be fonnatted before you 
can save information on them for the first time; . 

sam^e as initiaH^. 

frequi'iicyi The rate at which a repeiiisve event 
recurs. In alternating current (AC) signals^ the 
number of cycle* per second. Frequency is usually 
expressed in hertz Cc>'ctes per second), 
kilo hertz, or megahertz. 



lunctlOint A progmmmed sequence of operations 

that can be carried out on request from any point 
in a program. A function takes one or more 
arguments and returns a single value. It can 
therefore be embedded in an eJcpressEon, 

game I/O eoEincoors A l6-pin connector irtside 
all the open models of the Apple 11, originally 
designed for connecting hand controls to the 
computet, but aL?o used for connecting some 
other peripheral devices. Compare hand control 
eonoeetor. 

GLUj Acronym for general logic unii a dass of 
cusiom Inte^aied circuits used as interfaces 
between different parts of the computer. 

graphj A pictoria] representation of data. 

gmphJf^ (1) Information pr&scnted In the form 

of pictures or imagies. (2) The display of pictures 
or images on a computer's display screen. 
Compare text. 

hand controls^ Peripheral devices, with rotating 
dials and push buttons. Hand controls aje used to 
control game- play mg programs, but they can atso 
be used in other applications. 

hand control connectort A 9'pin connector on 
the back panel of the Apple He, Apple flc, and 
Apple IIGS computers, used for connecting hand 
controls to the computer. Compare game I/O 
connector. 

handshaking; The exchange of status 
inrormation between a DCE and a DTE used to 
control the transfer of data between them. The 
status information can be the state of a signal 
connecting the DCE and the DTE, or it can be in 
the form of a character transmitted with the rest of 
the data. See also XON and XOFF. 

faertz^ The unit of frequency of vibration or 
oscillation, derincd as the number of cycles per 
secofui^ Named for the physicist Heinrich Hertse 
and abbreviated Hz. See also klloher n, 
megahertz. 
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hex^dcclnuLb Ttic base -id system of numbers, 
vsing ihe ten digits ihirough 9 and the six tellers A 
thfoiigh F. Hexadecimal numbers can be 
converted easily and direaly lo binary form, 
because each hexadecimal digit correspond<i 10 a 
sequence of four bits. Hexadecirti3l numbers are 
LLSuaJly preceded by % dollar sign ($). 

hJgh-lcvel language: A programming language 
that is rclaJively easy for people Lo understand. A 
single statemeni in a high-level language t/pically 
corresponds to several insuuction-s uF machine 
language. Compare low-level language. 

hJgJi-ordcf byte; TTic more signifEcani half of a 

menior>' address or other multi-byte quanUiy. In 
the 6502 microprocessor osed in the Apple II 
Family of compuierSj the low-order byte of an 
address is usually stored first, and ihe high-order 
byie second. (In tl^e 68O00 microprocessors u.^d 
in the Maciniosh family, the high-order byte is 
stored first.) 

HJRes: A high ■resolution display mode on the 
Apple II family of computers, consisting of an 
array of points, 280 wide by 192 high, with 6 
colors. 

ifz: Sec hertz. 

128K Apple II: Any standard Apple U with both 
main and auxiliary 64K banks of RAM, That 
Includes all models of the Apple lie and somte 
modcLs of the Apple He, including those with the 
Extended SOColumn Text Card irLSt^llcd. The 
Apple lies Is not a 128K Apple II in the iirici 
sense, even though it includes both 64K banks of 
RAM and is capable of running programs designed 
for a 128K Apple IT. 

lO Sec Integrated circuit 

icons An image thai graphically represents an 
objea. a concept, or a mes^^age. 

Implementi To put into practical effect, as to 
innpiement a plan, For example^ a language 
translator implements a panicular language. 



index regbiter: A negLster in a computer 
pfocessar that holets an index for use in indexed 
addressing. The 6502 and 65C816 

micropftxiessors used in the Apple II family of 
computers have two index registers, called the 
X register and the Y register. 

Indexed addressing: A method used in 

machine-language programming to spedfy 
memory addresses. See also memory location. 

input: (n) Information iransFerred into a 
computer from some external source, such as the 
keyboard, a disk drive, or a modem. 

frtput/outpiit (I/O): The process by which 
information Ls trjnsferred between the computer's 
memory and ics keyboard or peripheral devices. 

Instruction: A unit of a machine-language or 
assembly-language program corresponding to a 
single action for the computer's processor lo 
perform. 

integrated circuit; An electronic circuit, 

including components and interconnections, 
entirely contained in a single piece of 

semiconducting material, usually silicon. Often 
referred to as an /Cor a thift. 

interactive: Operating by means of a dialog 
between the computer system and a human user. 

interfaces CD The point at which independent 
systenis or di^-ersc groups interact. The devices, 
rules, or conventions by which one component of 
a system communicates with another. Also, the 
point of communication between a peraon and a 
computer. (2) The part of a program that defines 
constants, variables, data structures, and 
procedure-calling conventions, rather than 
procjcdures themselves. 

li^terface cird: A peripheral card that 
implements a particular interface (such as a 
parallel or serial interface) by which the computer 
can communicaic with a peripheral device such as 
a printer or modem. 
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Intermpti A [cmporary su*penusfon in the 
exccuLiOfi of a. progfam that allows the computer to 
perform some oiher task, typically in response lo a 
signal from a fx;r[phcra] dcvloe or other source 
ejcicrnal to ihe compuief, 

I/Oj Sec input/ovitput 

I/O devkci inpuE^^ouEput device, A device ihai 
Lrarutfer5 infontiaiion into or oui of a computer. 

I/O link: A fixed location that contains the 
address of an inpui/output subroutine in ihc 

cnnipuEer's Monitor program. 

IWM; Abbreviation for Integrated Woz Machine, 

the custom chip used Ln built-in disk ponsi on 
Apple computers. 

JoystJck: A peripheral device with a kvcr, 
Lypically used to move creatures and objects in 
game programsi a py slick can also used in 
applications sudi m computer-aided design and 
graphics programs. 

Kj Stje kilobyte, 

keyboard: The .set of keys, simjlar to a typewriicr 
keyboard, used for entering information into the 

computer. 

kilobits A unit of meajSiMcment, 1024 bits, 

commonly used in specifying the capacity of 
memorv' ICs. Not to be confused with kl1ob>te. 

kilobyte {K}: A unit of measurement of computer 
data Of memory^ consisting of 1024 (2*^ bytes. 
^Xlien used this way, kilo Cfrom the Greek, 
meaning a thousand) stands for 1024. Thus, 64K 
memory equals 65,536 bytes, See also megab>ie. 

kJlohertfi A unit of measurement of frcqueiicy, 
equal to lOCX) hcrt2 (abbreviated kWfX See also 
megahertz. 

KSWs The symbolic name of the location in the 
computer's memory where the standard input link 
(nanwily, to the keyboard) is stored. A^Wf' stands 
for keyboard switch, 

language: See projiramnirng language* 



langysige card: A peripheral card that, when 

installed in slot of a 48K Apple II Of 
Apple II Plus, gives the computer a total of 64K of 
memory. In Apple II's with 64K or more of 
memory, the part of memory equivalent to that 
occupied by a language card is sometimes called 
language-card memory', 

liae length: The number of characters that fit in a 
line on the screen or on a page. 

load: To transfer information from a peripheral 
storage medium (such as a disk) into main 
memory for use — for examplef to iran^fer a 
program into memory for execution. 

loader: A program that brings files from a dL&k 
Into the computer's memory. 

locatl an: See mecaory location. 

lof^c boards See main Ingf c board. 

loop: A section of a program that Is executed 
repeatedly until 3 limit or condidon is met, such M 
an index vafiable's reaching a specified ending 
value. See Iq-op, 

kiW' level lafiguage: A programming language 
that is relatively close to the form the computer's 
processor can execute directly. One state nwnt in a 
ioW'levcl language corresponds to a single 
machine- language instruction. Compare hjgli' 
level lajiguage, 

kiW'Order bTrte? The leait .^ign intent byte of a 
memory address or other multt-b>'te quantity. In 
the 6502 and 65C816 microprocessorB used in ihe 
Apple 11 family of compojters, the low-urder byte 
of an address is usually stored first, and ihe high- 
order byie last. On the 68000 microprocessors 
used in the Macintosh family, the high -order byte 
is stored first.) 

Lo-Resi The lowest-resolution graphics mode on 
the Apple II family of computers, consisting of an 
array of blocks 4S high by -10 wide with 16 colors. 
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machine language: The form In which 

insLmctiorLs to a computer arc sioredl in memiSfy 
for dirccL execution by the compuijer's processor. 
Each mode! of computer processor (such as the 
6502 microprocessor used in fr-bti Apple IT 
computers) has its own form of machine language. 

Macintosh: A family of Apple eompuiers built 
around 68000 micr(>proccssors, having high- 
resoluiiors black-and-whiit; disptays and using, 
cnouse devices for choosing commands and for 
drawing pictures. 

macro: A single predefined assembly-langwage 
piseudo-instmcLlon ihai an a&semblcr replaces with 
several actual instnactions. iMacros arc almost like 
higher-level insuudions thai can be used inside 
assembly-la nguagic programs, making the 
programs easier to write. 

macro assembler: A type of assembler that 

allows [he programmer lo define sequences of 
several assembly-langMage instrudioris as single 

pseudo-instructions called macrosi. 

main logic boards A large circuit board ihat holds 
RAM, ROM, the microprocessor, custom 
integrated circuits, and oiher componcnis that 
make ihe computer a computer. 

main racmoryj The part of a computer's 
memory whose contents are dlrtaJy accessible to 
the microprocessor; usually synonymous with 
random-access memory (RAM), 

MARK parity: A bit of value 1 appended to a 
binary number for transmission. The receiving 
dc\i^ce checks for errors by looking for this value 
on each character. Compare e%Ta parityt odd 
parity. 

Meg^ H: A custom large-scale integrated circuit 
that incorporates most of the timing and control 
circuits of the standard Apple n. It addresses 128K 
of RAM organized as 64K main and auxiliarr' banks 
and provides the standard Apple II video display 
modes, both text (40'cotumn and 80-coiumn) and 
graphics CLo-Res. Hi-Res, and Double Hi-Res). 



megabits A unit of nicasurementp 1,048,576 (2^^ 
bits or 1024 kilobits* commonly used in 
specifying the capacity of memory iCs, Not to be 
confused with megabyte* 

megabyte: A unit of measurement of computer 
data or memory^ equal to 1,048,576 bytes or 
1024 kilobytes; abbreviated Mb. 

naegahert^t A unit of measurement of 
frequency, equal to 1,000^000 hertz 
(abbreviated MH^). Sck: also kilohcrtz. 

Euemocy: The hardware component of a 
computer system that stores informauon for later 
retrieval. See also main memory, random- 
access cnemoryT read-only memory, read- 
write memory. 

memory location: A unit of main memory that is 

identified by an address and can hold a single item 
of Information of a fixed size. In the Apple II 
family of computers, a memory location holds 
one byte. 

Memory Manager: One of the prograrns in the 

Apple IIGS Toolbox. Its job Is to allocate memDry 
so thai applications and desk accessories can run 
without clobbering each other. 

memory-cnappcd I/Of 1 he method used for I/O 
ope radons in Apple 11 computers, where certain 
nrtcmory locations are attached to I/O devices, 
and I/O operations ;ire jusi memory toad and 
store instmctions. 

memory-resident] Cadp (1) Stoned permanently 
in memory as firmware CROAO, (2) Held 
contintjally in RAM even while not in use. DOS is a 
memory -resident program. Compare disk- 
resident, 

menu: A list of choices presented by a program, 
from which you can select an action. See also 
desktop environment. 

menu bar: The horizontal strip at the top of the 
screen that contains menu titles. 
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menu cJtlet A word, phrase, or icon in the menu 
bar ihaL designates one menu. Pressing on ihc 
menu tide causes ihe titJe lo be highlsghicd and it^ 
menu to appeair below iL 

m flag; One of ihrcc flag bits in the 65CS16 
processor that progtrams use to control the 
processor's operating mode^. In native mode, the 
setting of the m flag determines whc[her the 
accumulator is S-bits wide or l64>its wide. See also 
« fl^S. X flag. 

MHz: Abbreviation for megahertz, one miltion 
henz. See hertz. 

microprocessor I A computer processor 
contained in a single integrated drcuit. The 
microprocessor Is the ccnir^ processing tinlt 
CCPU} of the microcomputer. Examples Include 
the 6502 and 65C816 microprocessors used in the 
Apple II family of computers and the 68OO0 
microprocessor used in the Macintosh family. 

mlcrosccondt One millionth of a second 
Abbreviated^, 

mrnilsecondi One thousandth of a second. 
Abbreviated ms. 

mode; A state of a computer or system that 
determines its behavior. A manner of operating. 

modem: Short for MOduMor/DEModulator, A 
peripheral device that links a computer to other 
computers and information services using the 
Telephone lines. 

monltort Sec video monitor. 

Monitor program.: A system program buitt into 
the firmware of Apple II computers, used for 
directly inspcaing or changing the contents of 

main memory and for operating the computer at 

the machine-language tevcL 

MOS: Abbreviation for metal oxide silicon, a 
method of semiconductor iniegratcd-circuit 

fabficaiion on silicon using layers of silicon 
dioxide in the make-up of the devices. Compare 
CMOS. 



mouse? A small device you move around on a Hat 
surface next to your cofnpuicr. The mouse 
controls a pointer on the screen whose 
movements correspond to those of tiic mouse. 
You use the pointer to select operations, to move 
data, and to draw with in graphics programs. 

mouse buttom The button on the top of tiie 
mouse. In general, pressing the mouse button, 
initiates some action on whatever is under ihe 
pointer, and releasing the button confirms the 
action, 

NTSG (1) Ahbfeviation for National Television 
Standards Committee. The committee that 
defined ihc standard format used for transmitting 
broadcast video signals in the United States. 
C2) The standard video format denned by the 
NT5C, also called composltei because it 
combines all the video information, including 
color, into a single signal, 

dibject code: See ob|ect program. 

object prograiQi The translated form of a 
program produced by a language translator such 
as a compiler or assembler. Also called object 
code. Compare source program. 

odd paHtyt In data transmission, the use of an 
extra bit set to or 1 as necessary to make the total 
number of I biis an odd numbcn used as a means 
of error checking. Compare even parity, MARK 
parity. 

12gK Apple H: Any standard Apple II wi[h both 
main and auxiliary 64K banks of RAM. That 
includes all models of the Apple lie and some 
models of the Apple He, including those with the 
Extended 80-Column Text Card installed. Ihc 
Apple lies is not a I28K Apple II in the Stria 
sense, even though it includes both 64K banks of 
RAM and is capable of mnning programs designed 
fort 128K Apple II 

opcodet See operation code. 
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open Apple key; A modirier key on $ornc 
Apple II -family keyboards^ on ihe Apple IIGS 
keyboard, ihe cquivaienL key \& marked with both 
sin Apple Icon and a spinner, the icon used on 
some MadnLosh keybc^rds, and called dimply ths 
Apple key. 

operation codes Hie machine-language 

fepresemaiion of a campuicr instruction, 

operating systems A j^eneral-purposc program 
thai manages the actions of the parLs of iJic 
computer and its peripheral devices for ttic benefit 
of the application programs. Sec dbik operating 
system. 

ovemiii: A condiiksn that occurs when the 
processor does not icirieve a received character 
from the rtjcclve data fcgisicr of a 
cominunicaLions interface device befote the 
subse<;ucni character arrives to occupy that 
register. 

page: (1} A segmtcnt of main memory 256 bytes 
long and bcginmng at an addre^ thai is an even 
multiple of 256. (2) An area of main memory 
containing text or graphical information being 
displayed on ihc screen. Page is usually 
capitalized when it has thi!i meaning. 

page lero: See zero pajce. 

paraUel tnterfacet An interface In which several 
bits of informs u'on (typically 8 bits, or 1 byte) arc 
tran.smi[icd simuttaneousty over different wires or 
channels, Compare serial fnterface, 

paraoielen An argument that determines the 
outcome of a command- For example^ in the 
command wnteC%msg), nand migare 
parameters. 

parilyt Sameness of level or count, usually the 
count of 1 bits in each character, u*cd for error 
checking in data transmission. 5ee even parity, 
MARK parity, odd parity^ parity blL 



parity bit A bit used to check for errors during 
data transmission. Expending on the number of ] 
bits in a transmission, the parity bit is set to 1 or 
lo make the total number- of 1 bits even or odd. 

PSkSf^ A high-level programming language with 
statements that re^mblc English phrases. Pascal 
was designed to teach programming a$ a 
systematic approach to problem solving, Named 
iUi&r the philosopher and mathematician Rlaise 
Pascal, 

peripheral! (adp At or outside the boundaries of 
ihe computer iiself, either physically (as a 
peripheral device) or In a Logical sense Cas a 
peripheral card), Co) Short for peripheral deuice, 

peripheral cards A removable prinicd-drcuit 
board that plugs into one of the computer's 
expansion slots. Peripheral cards enable the 
computer to use peripheral devices or to perform 

other subsidiary or peripheral functions, 

peripheral device: A piece of hardware — such as 
a video monitor, disk drive, printer, or 
modem — ^used in conjunction with a computer 
sind under the computer's control. Peripheral 
devices are often (but not necessarily) physically 
separate from ihe computer and connected lo it lay 
wires, cables, or some other form of interface. 
They often require peripheral cards. 

peripheral slot; Sec ezpanston sloL 

phase? (1) A siage in a periodic process. A point 
in a cycle. For example, the 65CS16 
microprocessor uses a clocJ? cyde consUting of 
two phases called <IK) and <1>1, (2) The relationship 
between two periodic signals or processes. 
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plxeL Short for piciutv element. The smaltesi dot 
you can di^w on ihe screen. Also, i locziion in 
video memory that corresponds lo a poini on the 
graphic!! screen when the viewing window includes 
that location. In the Maciniosh display ^ each pixel 
can be either black or while, so it can be 
reprcscnicd by a b(t; thus, the dispby is said lo be 
t bftmap. In the Super Mi -Res display on Lhe 
Apple IJGS, each pixeJ is represented by either [wo 
or four bits; the display is not a bitmap, bui rather 
a pixelmap. 

pLxekimp: A set of valuc5 that rcpHS^iiUs the 
positions and stales of the set of pixefe making up 
an image. Compare bitmap. 

pop: To rciricve an cnirif' from the lop of a stack, 
moving the stack pointer to point to the previous 
entry. Compare push, 

port4 A socket on the back panel of the computer 
where you can plug in a cable to connea a 
peripheral cJevioe^ another computer, or a 
network. 

PR#: An Applesoft BASIC command that directs 
output to a slot or a machine-language program, [t 
activates an ouiput routine In the ROM on a 
peripheral card or in equivalent RAM by changing 
the address of the standard output routine uv:.':.! by 
the computer. 

proc€diirei In the Pascal and Logo programming 
langaagies, a sequence of instructions that work as a 
unit-, approKimately equivalent lo ihc term 
function in C or subrouUtte in BASIC. 

processors The hardware componcrsi of a 
computer thai performs the actual compuiation by 
directly executing in.stnjction.'i represented in 
machine language and stored in main memory. 
See microprocessor. 

ProDOS: A disk operating System for the 
Apple II family of computers. ProDOS stands for 
Ptfjjes&ional Disk Operating System^ and include* 
ProlX)S S and ProDOS 16. 



PtoPOS 8j A disk operatinB system For ihc 
Apple II. It runs on 6502 and 65O02 
microprocessors and on the 65C816 In 6502 
emulation mode. 

ProDOS 1& The disk operating system 

designed for the Apple IlGS, ProDOS l6 is similar 
to ProDOS 3, but was designed to mn on the 
65CS16 microprocessor in the Apple IIGS. 

program.: Cn) A sequence of instructions 
describing actions for a computer to perform in 
order to accomplish some task, conforming lo ihe 

rules and conventions of a particular 
programming language, (v) To write a program. 

programmabie read-only memory (PROM): A 
tyt>e of ROM device thai is programmed after 
fabrication, unlike ordinary ROM devices, which 
are programmed during fabrication. 

prosramming Language: A set of symbols and 
associaied rules or conventions for wricing 
programs. BASIC^ Logo, and Pascal are 
programming languages. 

PROM: See pragrammahle read-only 
memory* 

prompt: A message on ihe screen that tells you of 
some need for response or action. A prompt 
usually lakes tlic form of a symboS, a message, a 
dialog box, or a menu of choices. 

prompt charmcter; A text character displayed on 
the screen, usually just lo the Icfi of a cursoft 
where your nejKi action is expected. The promp* 
character often idcniifies the program or 
component of the system that's prompting you. 
For example, Applesoft BASIC usc^ a square 
bracket prompt character (D-. the system Monitor 
program, an asterisk C*); and Uie Mini-assembler, 
an exdamatiort poEnt (D. 

protocoli A formal set of rules for the interchange 

of information between two programs or devices-, 
for example^ the njles for sending and receiving 
data on a communication line. 
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FrolocuE Converter: A sci of ROM-ba.s^d 
assembly-language rouiineij us<;d Lo support 
extemail I/O dcvtccs such as the Apple Memory 

Expansion Card and ihe Apple 3.5 Drive, 

piLsh: To add an entry to the lop of a stack, 
moving (he Slack pointer to point to it Compare 
pop. 

queue: A list in which entries are added at one end 
and removed sit ihc other, causing entries to be 
removed tn first-in, firstout CHFO) order. 
Compiirt ^tjick. 

QWTLHtT kiryboard; The standard Eayout of keys 
on a tyjxiwrucr keyboard^ its name is formed fromi 
the first six lettei^ on the top row of IcUcr keys. 
Compare Dvorak keyboard. 

RAM; See rajidoro-access memory. 

RAM disk; A feature of some operating systems 
which makes it possible to use programmable 
memory CRAM) as a disk volume. Large 
applications designed for m^ichtnes with timitcd 
amounts of It-^M must load program segmenLs 
from disk as needed; on machines wiih RAM disk, 
the entire application is first loaded into RAM, 
where it njns as If stitl resiilcnt on disk, but much 
faster 

nuidom- access memory CRA-M)? Memory in 
which information can be referred to in an 
arbitrary or random ordeir. As commonly used, 
RAM means the p3in of memory available for 
programs from a disk; ihc programs and other 
data are losi when the computer is turned off. 
Occhnlcally, the read-only memor>' (ROM) is 
atso random access, and what's called FIAM 
should correctly be termed rcad-wnw memory.') 
Compare read-only mcinnry, read- write 
memory^ 



read-anty memory (ROM): Memory whose 
contents can be read, but not changed; used for 
fitoring firmware. Information is placed into 
read-only memory once^ during manufactufie; it 
then remains there permanently, even when the 
computer's power is turned off. Compare 
random- access memory, read-write 
memor>% write-only memory. 

read-write memory: Memory whose contents 

can be both read and changed (or written to); 
commonly called RAM, The information 
contained in read-write memory is erased when 
the computer's power is turned off and is 
permanently la"^t unless it has been saved on a disk 
or other storage device. Compare random- 
access memory, read -only memory. 

reeriirant: Character ij^tic of a program routine 

that is able lo accept a call white one or more 
previous calls lo it are pending without 

invalidating any previous calls. 

register: A location m a processor or other 

device where an Item of information is held and 

modified under program control 

Resource Manager: A Macintosh toot for editing 
daia in program segments without recompiling 

them. 

resident: ?tcc. memorj'-resldent, disk- 
resident. 

return address: The point in a program to which 

control returns on completion of a subroutine or 
function. 

RGB: Al:>brcviatJon for red-green -blue, a method 
of displaying color video by tran.smitt[ng the three 
primary colors as three separate signals. 'ITicre are 
two ways of using RGB with computers; TfL RGB. 
which allows the color signals to lake on only a few 
discrete values; and analog RGB, which allows the 
color signals to take on any values between their 
upper and lower limits, for a wide range of colors. 
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RGB monitor: A type of color moniior [hat 
receives separaLe sij^als For tach color (fed, 
green, and blue). Compare composite video. 

ROM: ^e read-only memory. 

ROM disk: A feature of some operating systems 
making ii possible lo use read-only memory 

CSOM} as a disk volume. Often used for making 
applicaiions peraianently resldeni. Sec aUo RAM 
disk. 

routine: A part of a program that accompttshes 
some task subordinaic to ibc overall tajik of the 
program. 

row; A horizonial line of character cells or 
graphics pixels on the screen. 

R5-232t A common standard for serial dala- 

communlcation intef faces, 

RS-^Zl: A standard ^or serial data- 
communication interfaces, different from the 

RS-232 standard in its electrical chiracitrisiics and 
in its use of difTercniial patrs for data signals. The 
serial ports on tlie Apple lies use RS-42Z devices 
modified 50 as to be compatibte with RS-232 
devices. 

SANE: See Standard Apple Numeric 
Environments 

SCCi See Serial CommiiEi]i;atlon<v Controller. 

screen holes: Locau'ons in the icxl display buffef 
Ocxi Page i) used for icmporary -storage either by 
\/0 rouitnes running in peripheral -card ROM or 
by firmware routines addressed as if they were in 
card ROM. Text Page 1 occupicii memor>' from 
$0^00 lo S07l-Fi line screen holes are location.s in 
itiai area tliat are neither displayed nor modiried 
by the display firmware. 

Seriitl Communications Controller (SCC): A 
type of communications IC used in the Apple IIGS 
computer. Compare AOA, 



serial Lntcrface^ An interface in which 

information Is [ransmitied sequenLlally, a bit at 3 
lime, over a single wire or channel. Compare 
parallel interface. 

serial port The connector for a peripheral device 
that uses a serial inurr:ice+ 

slUcom A solid, crystalline chenncal element 
(symbol Si) from which integrated circuits are 
made. Silicon is a semiconductor; that is, it 
conducts eleclridty better than insulalars, but not 
a* well as metallic condurtors. Silicon shouEd not 
be confused with silica — that Is, silicon dioxide, 
such as quanT:^ opal^ or sand — or with silicone, 
any of a groiip of organic compounds containing 
silicon. 

Simplified Key1>oard: See Dvorak keyboard 

MK Appk- II: Any standard Apple II that has at 
least 64K of RAM That includes the Apple lie. ihe 
Apple IIc» and an Apple II or Apple II Plus with 
4BK. of RAM and the Apple Language Card 
Installed. 

6502; The microprocessor used in the Apple n, in 

the Apple 11 Plus, and in early models of the 
Apple lie. Tl-ie 6502 is an MOS device with 8-bii 
data registers and 1 6-bit address registers, 

65C02: A CMOS version of the 6502; the 

microprocessor used in tJie Apple lie and in the 
enhanced Apple Uc. 

65C8l6j The mtcroproccssof used in the 
Apple lies. 'Hie 65C816 is a CMOS device with 
16-bit data registers and 24-bit address regisiers. 

6BOOO3 The microprocesAor used in the 
Madntosh and Macintosh Plus. The 68000 has 
32-bit data and address registers. 

slot' A narrow socket inside the computer where 
you can install peripheral cards. Also called an 
expansion sloL 

soft switch: A location in memory that produce 
some specific cJTcct whenever its contents are read 
or written. 
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suftwarci A coUeclive term for progrAmSv ihe 

jnstruciiuns Lhai Let] ihe computer what lo do. 
They're usually s[ared on disks. Compare 
flrcn^ware. 

source code; See source program, 

source program; The form of A prugriim gjvcn lo 
a lanj?uagc translator, such as a compiler or 
a-sst.:mLilcr, for conversion inLo another farmi 
scunelimes L^allcd source code. Compare abject 
program. 

stack: A list in which etiTrfcs arc added (pushed) 
or removed (popped) at one end only (the top ot 
ihe stack), causing them to be removed in last-in, 
first-out (UFO) order. Compare queue. 

utaiidard Apple IB Any computer in the Apple It 
family except the Apple IIGS. That includes the 
Apple II, ihe Apple 11 Plus, the Apple lie, and the 
Apple He. 

Standard Apple Numerics Envtronmetit 
(SAXE): Apple's implenietnation of lliE-ilv standard 
floaiing-poini arithmetic, used on t)ic Apple It 
and Macinioih families of computers. 

start bib Orie or two bits that indicate the 
beginning of a charaaer in a su'ing of serially 
trans mined characters. 

start up; To get the system mnning. Starting up Is 
the proce;^ of first reading the operating syntem 

program from the diisk, and then running an 
application program. Starting up is often called 
booHng. 

startup dLsk: A disk ^^^lh all the necessary 
program tiles to set the computer into operation. 
Sometimes called a hoot disk, 

stop bit: A bit indiaiting the end of a characiei" in 
a siring of serially transmitted characters. 

strobe: A signal whase change is used to trigger 
some action. 

subdirectory^. A dirednry within a directory. A 
file coniainjng the names and locatiorw of other 
files. 



subroutine: A part of a program that cani be 
executed on request From another point in the 
program and il^aij on complclionf returns control 
to that point 

syncbrotiQus: A mode of data transirusslon in 
which a consiant lime interval exists betWi'een 
transmission, of successive bits, characters, or 
events. Conipare asynchronous* 

system: A coordinated collection of interrelated 
and interacting parts organisced to perform some 
function or achieve some purpose — for example, 
a computer sysicm comprising a processor, 
keyboard, monitor, and disk drive. 

system ennflguratjom Sec cunflguratlon. 

system progi^m,: A program that makes the 
resources and capabilities of the computer 
available for general purposes, such as an 
operating system or a language translator. 
Compare application program. 

system software: The component of a computer 
system that supports application programs by 
managing sysicm resources such as memory and 
I/O devices. 

text (1) lnform:ation presented in the form of 
readable characters. (2) Ti>e display of characters 
on a display screen. Compare graphics. 

te:xt wlntiow: A window on the desktop within 
whidi text is displayed and scrolled, 

tooUjox: A collection of buHt-in routines Llial 
programs can call to perform many commonly 
needed functions. 

triinjiiitortransi-stor logie (TTl): (0 A family 

of integrated circuits having bipolar circuit logic; 
TTl, ICs are used in computers and related devices. 
(2) A standard for interconnecting such circuits, 
which defines the voltages used to represent 
logical zeros and ones. 

TTLs See tran^Ifitor- transistor logic. 
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TTL RGB; A lype of video monitor ihai can accept 
only a limiLedl nLimber of distal vtlue^ and display 
onJy a correspcindtngly Limited nui[±»er of color^- 

Compairc analog RGB, 

type-aliead bulT&rt A bulfer that acccipts and 

holds charactei^ that are typed faster thari the 
compuler can process Lhem. 

usen A person operating or corLLroUlng a 
computer system. 

usci" Interface; The rules and conventions by 

whld'i a tumputer system communicalcs with the 
person 0[Xirating it, 

utUitJest Programs that lei you rename, copy, 
format, delete, and otherwise manipulate files and 
volumes. 

value: An lu^m of informailon that Okn be stomd 
in a vajiable, such as a number or a suing, 

Yarlable CD A location In the computer' j 
memory where a valu^ can be sioned <2) The 

symbol used in 3 pfogram 10 represent sudi a 
location. 

VBL: Short for vertical blanking, an interrupt 

signal generated by the video timing circuit eadhi 
time it fmishtii a ^■erticial &can, 60 time^ a second. 

vector: (O The .^iLiftLng address of a program 
segment when used as a common point for 
transferring control from other programs. C2) A 
memory location used to hold a vector, or the 

addr^s of such a location. 

vjdeot CD A medium for transmitting information 
in ilie Turm of images to be displayed on the 
scnsen of a caihodc-ray tube. (2) Information 
organ is'.ed or iransmiited in video form* 

video monltort A display device that can receive 

video signals by direct Cdnnettion only, and that 
cannot receive broadcast signals such as 
commercial television. Can be connected directly 
to the computer as a display device. 



warm starts The process of transferring control 
back to the Ofwratlng system in response to a 
failure in an appUation program. Compare cold 
starL 

^VFliidow^ The area that displays infnrmadon on a 
desktop. You view a document through a window. 
YcHj can open or dose a window, mo^-e it around 
on the desktop, and sometimes change its sisce, 
scroll through it, and edit its contents. 

word: A group of bits that is treated a.s a unit. The 
numtM^r of bits in a word is a characteristic of each 
particular 'Computer;, in the Apple llGS^ words are 
sixteen bits wide. 

wrafiai'ouiid; The automatic continuation of text 

from the end of one line to the beginning of the 
nexti wraparound means that you don't have to 
press the Return key at the end of each line as you 
type. 

wxite-only memoryt A form of computer 
nr^raory into which information can be stored but 
never, ever retrieved. For more information, refer 
to The Life o/HombeTg T. Farmfitj^e, by Bmce 
Togna//.ini. 

X nag; One of three Rag bits in the 65CBl6 

processor that programs use to control the 
processor's operating modes. In native mode, the 
setting of the k HAg determines whether the index 
registers are 8-bits wide or 16-biis wide. See c f1^ 
m flag. 

XON; A sp<;cial character CASCli ^lalue $135 used 
for cnntroEling ilie trar^sfer of data between a DTE 
and a DCE See EiAnd^hakLng, XQFF» 

XOFFi A special character (ASCtt value 511) used 

for controlling [he transfer of data between a DTE 
and a DC£. TK-lien one piece of eqiiipment receives 
an XOFF character from the other, it stops 
trarismilttng characters until it receives an XON. 
See hand^ilxaJdng, XON* 

X fegfeten One of the tw^o index registers in the 
65t^l6 and 6502 microprocessors. 
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Y register: One of ihe two index regisicrs in ihe 

65CBI6 and 6502 microprocessors- 

zero page: The firet page (256 bylcs) of memory 
in the Apple I] family of computers^ also called 
page zero. Since the high -order byte of any 
addfcs* in ihis page ts zero, only ihc low-order 
byte ts neecJed lo specify a zero-page address; ihts 
makes zero-page locaiions more effideni lo 
address, in both [irtie and space, than locations in 
any other page of memory, '['he 65CBI6 
niicroprocessor used in the Apple IIC5 has a 
relocatable zero page called the direct page* 
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Scrap Manager 71 
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standard [/O links 51-52 
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System Loader 96 

Window Manager 66 
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keyboard 49 
aspect ralk^s 61 
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APW AsKmbler 101-102 
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mtns-assemblcr 50 
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bank $00 16. 61 

Altemalc Display Mode 47, 68 

direct page location 83 
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8-blt programs 83 

jnlerrupts 54 

I/O links 52 

language-card switches 4S 

memof-y map 79 

memory shadowing 29i 77-79 

sUick locanbn 83 
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inieerupis 54 
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memory map 79 
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Super Ht-Res display 87 
bjitik $02 t3, 79 
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baud rate 35k ^6 
binary fdes 8, 95 
bit-mapped memory 95 
block I/O device suppon 40 
block-storage device (/]1AM5> ^0, 79 
booting 40, 95 
border colors 3, 46 
break cbaradcr, I/O command 36 
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burrering, I/O 37-38 
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serial I/O ports 
built-in keyboard CApple He? 42,43 
biiLll-in RAM SO 
bu^t-jn ROM 80 
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CMOS (Complementary MctaJ Oxide 
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Cobot 105 
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cursor position 53 
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daisy-chain drive connection 59 

data bank regislcrs 13, H, 83 
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echo auiput, J/O command 35 
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Editor (APW5 S. 104 
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operating system 95 

program environments 89-90, 
115 
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slack locaiik^n 81 
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linc-rccd chaiactcr masking, I/O 
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